gcloud: Wed Mar 13 09:56:21 UTC 2024

gcloud/artifacts/docker/upgrade/migrate

@@ -0,0 +1,73 @@
+NAME
+    gcloud artifacts docker upgrade migrate - migrate projects from Container
+        Registry to Artifact Registry
+
+SYNOPSIS
+    gcloud artifacts docker upgrade migrate [--copy-only]
+        [--from-gcr=GCR_HOST/PROJECT_ID] [--last-uploaded-versions=N]
+        [--max-threads=MAX_THREADS; default=8] [--projects=PROJECTS]
+        [--recent-images=NUM_DAYS] [--skip-iam-update]
+        [--to-pkg-dev=PROJECT_ID/REPOSITORY_ID] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Migrate projects from Container Registry to Artifact Registry
+
+EXAMPLES
+    To migrate a project my-project using gcr.io repositories:
+
+        $ gcloud artifacts docker upgrade migrate --projects=my-project
+
+    To migrate several projects using gcr.io repositories:
+
+        $ gcloud artifacts docker upgrade migrate \
+           --projects=my-project1,my-project2,my-project3
+
+    To migrate a project using pkg.dev repositories:
+
+        $ gcloud artifacts docker upgrade migrate \
+           --from-gcr=gcr.io/project1 --to-pkg-dev=project2/repo_name
+
+FLAGS
+     --copy-only
+        Only perform image copying
+
+     --from-gcr=GCR_HOST/PROJECT_ID
+        Container Registry host + project to copy from. This flag is only used
+        when migrating to pkg.dev repos. Example: gcr.io/my-project
+
+     --last-uploaded-versions=N
+        Only copy the N most recently uploaded versions of each image. More
+        than N images may be copied if new images are uploaded during
+        migration.
+
+     --max-threads=MAX_THREADS; default=8
+        Max number of images to copy simultaneously. Consider quota usage when
+        increasing this
+
+     --projects=PROJECTS
+        Comma seperated list of Container Registry projects to migrate to
+        Artifact Registry gcr.io repositories.
+
+     --recent-images=NUM_DAYS
+        Only copy images pulled or pushed in the last NUM_DAYS days. NUM_DAYS
+        must be between 30 and 90 inclusive.
+
+     --skip-iam-update
+        Migrate without changing iam-policy. Users without Artifact Registry
+        permissions will not have access to migrated images.
+
+     --to-pkg-dev=PROJECT_ID/REPOSITORY_ID
+        Artifact Registry pkg.dev project ID and repository ID to copy to.
+        Example: my-project/my-repo
+
+GCLOUD WIDE FLAGS
+    These flags are available to all commands: --access-token-file, --account,
+    --billing-project, --configuration, --flags-file, --flatten, --format,
+    --help, --impersonate-service-account, --log-http, --project, --quiet,
+    --trace-token, --user-output-enabled, --verbosity.
+
+    Run $ gcloud help for details.
+
+API REFERENCE
+    This command uses the artifactregistry/v1 API. The full documentation for
+    this API can be found at: https://cloud.google.com/artifacts/docs/