hslr-s/artifact-migrate

Public

WeChat Login

Code ISSUE Pull requests Events Packages Insights

main

Branch

Tag

Forkfromcnb/plugins/cnbcool/artifact-migrate, behindmain22 commits

合并来自 alter-readme 的合并请求 #89

0452855d

186 commits

cmd
config
docs
internal
utils
vendor
.DS_Store
.cnb.yml
.gitignore
CONTRIBUTING.md
Dockerfile
LICENSE
README.en.md
README.md
build.sh
go.mod
go.sum

CNB Artifact Migration Tool

Features

Supports migrating maven and npm artifacts from Coding, Nexus, Jfrog, and Codeup platforms to CNB

Using with Docker

Notes

⚠️ Ensure the CNB artifact repository exists before migration
Nexus, Jfrog mainly support local repositories
For Nexus repositories with over 10,000 versions, please configure a migration list (otherwise only 10,000 versions will be migrated)
Codeup currently doesn't support migrating plugin-generated metadata files

Migrating from Coding/Nexus/Jfrog to CNB

1. Mounting Configuration Files

Mount log directory: -v $(pwd):/app/log
Log files include execution logs, successfully migrated packages, and failed migrations
For incremental migration: Mount successfully migrated package files and configure path in config.yaml's excludePackageVersion

docker run --rm \
  -u root \
  -v /data/conf/config.yaml:/app/config.yaml \
  # Mount migration list when needed (configured in config.yaml's includePackageVersion)
  -v /data/conf/config-maven-includePackageName.txt:/app/config-maven-includePackageName.txt \
  # Mount exclusion list when needed (configured in config.yaml's excludePackageVersion) 
  -v /data/conf/config-maven-excludePackageName.txt:/app/config-maven-excludePackageName.txt \
  # Log directory
  -v $(pwd):/app/log \
  docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest

2. Parameter Mode (ARTIFACT_MIGRATE:parameter-mode)

Parameters:

SRC_INCLUDE_PACKAGE: Packages to migrate (format: package or package:version)
SRC_EXCLUDE_PACKAGE: Packages to exclude (format: package or package:version)
ARTIFACT_TYPE: maven or npm
SRC_REGISTRY_TYPE: jfrog, nexus, coding or codeup
SRC_REGISTRY_TOKEN: API token for Codeup

docker run --rm \
    -u root
    -e ARTIFACT_MIGRATE="parameter-mode" \
    -e ARTIFACT_TYPE="maven" \
    -e SRC_REGISTRY_TYPE="coding" \
    -e SRC_INCLUDE_PACKAGE="org.xxx:1.0.0|org.test" \
    -e SRC_EXCLUDE_PACKAGE="" \
    -e SRC_REGISTRY_URL="http://example.com" \
    -e SRC_REGISTRY_USERNAME="user" \
    -e SRC_REGISTRY_PASSWORD="pass" \
    -e TAR_REGISTRY_URL="http://cnb.cool/repo" \
    -e TAR_REGISTRY_PASSWORD="cnbpass" \
    -v $(pwd):/app/log \
    docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest

Using with CNB

Notes

⚠️ Ensure CNB artifact repository exists first
Place config.yaml in project root directory
Default CNB pipeline path: /workspace

main:
  push:
    - stages:
        - name: Artifact Migration
          image: docker.cnb.cool/cnb/plugins/cnbcool/artifact-migrate:latest

config.yaml Parameters

artifactory:
  maven:
    - src:
        type: coding # jfrog/nexus/coding/codeup
        includePackageVersion: # Packages to include (regex or file)
        excludePackageVersion: # Packages to exclude  
        url: http://example.com/repo
        username: user
        password: pass
        token: # For Codeup only
      target:
        url: http://cnb.cool/target
        password: cnbpass
        
  npm:
    - src:
        type: coding
        includePackageVersion: ^coding # Regex example
        excludePackageVersion: /app/exclude.txt # File example
        url: http://example.com/npm
        username: npm-user
        password: npm-pass
      target:
        url: http://cnb.cool/npm
        password: cnbpass