gh-gei

• Add --target-api-url to commonly used commands to support newer GitHub migration paths.
• Fixed gh ado2gh rewire-pipeline command for ADO Team Projects with more than 10,000 Build Definitions.

• Update bbs2gh inventory-report help text to document that personal repositories owned by users are not supported
• Update ado2gh lock-repo help text to document the scopes required for your Azure DevOps personal access token

• Add new gh [gei|bbs2gh|ado2gh] abort-migration command to cancel a migration that is in the queue or in progress
• Fix suggested command for downloading logs in gh gei migrate-repo log output

• Skip latest version check on startup if environment variable GEI_SKIP_VERSION_CHECK is set to true

• Redact X-Amz-Credential querystring parameters in AWS S3 URLs included in logs
• When redacting sensitive patterns in log output, use a non-case sensitive search

• Skip GitHub status checking on startup if environment variable GEI_SKIP_STATUS_CHECK is set to true
• Redact ?token= querystring parameter from GHES <3.8 archive URLs in logs

• Add a warning to help users who accidentally end up in the "running on the Bitbucket instance" flow in bbs2gh migrate-repo
• Fix version check so that a version later than the latest version published on GitHub isn't considered old
• Fix download-logs commands suggested by bbs2gh migrate-repo and ado2gh migrate-repo to use correct arguments
• Fix version number exposed in headers and generate-script scripts, removing the revision component so it matches the published version

• Extend timeout from 10 hours to 20 hours when generating GitHub Enterprise Server migration archives in gh gei migrate-repo

• When running migrations with gh bbs2gh and migrations from GitHub Enterprise Server with gh gei, create the migration source before starting the export

• Log migration warnings count after a migration completes

• BREAKING CHANGE: Drop deprecated --wait option for migrate-repo and migrate-org commands
• Allow Enterprise Managed Users (EMU) organizations to skip the invitation process in the reclaim-mannequin command with the --skip-invitation option
• Fix target repo existence check in GitHub Enterprise Server migrations so it doesn't error if the target repo used to exist, but has been renamed
• Fail fast if the target GitHub repo already exists in bbs2gh migrate-repo

• Validate that the --ghes-api-url is a valid URL in gh gei generate-script
• Allow CLI to fail fast when an unauthorized token is provided by preventing retry logic on 401 errors
• Improve performance when reclaiming a single mannequin with reclaim-mannequin
• Improve logging for reclaim-mannequin command
• Ensure that CLI runs have separate log files, even if they start at the same time, by adding the process ID to the filenames

• Include the databaseId (GUID) in the verbose logs when starting a migration
• Fix recommended gh gei, gh bbs2gh and gh ado2gh commands in log output

• BREAKING CHANGE: Require the AWS region to always be specified with the --aws-region argument or AWS_REGION environment variable if using AWS S3 for blob storage. Previously, this was optional (with a warning) if you weren't specifying an AWS session token.
• BREAKING CHANGE: Drop support for deprecated AWS_ACCESS_KEY and AWS_SECRET_KEY environment variables in gh gei and gh bbs2gh. The AWS S3 credentials can now only be configured using the industry-standard AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY variables or command line arguments.
• BREAKING CHANGE: Require the Bitbucket Server URL, project key and repo to always be provided for bbs2gh migrate-repo, even if using the upload-and-migrate (--archive-path) or migrate-only (--archive-url) flows
• Increase timeouts in archive uploads to AWS to prevent timeouts during large uploads

• Add additional error handling to reclaim-mannequin process
• Removed ability to use gh gei to migrate from ADO -> GH. You must use gh ado2gh to do this now. This was long since obsolete, but was still available via hidden args - which have now been removed.
• Add bbs2gh inventory-report command to write data available for migrations in CSV form

• Improve log sanitization to also remove secret values that have been URL encoded
• Warn when the --ssh-port argument for bbs2gh migrate-repo and bbs2gh generate-script is set to the default port for Git operations

• Hide the reclaim-mannequin --skip-invitation option from documentation, since it's still under development and not yet available

• Write warnings to log and console if GitHub is experiencing an availability incident.
• Improve the error thrown when you have insufficient permissions for the target GitHub organization to explicitly mention the relevant organization
• Write log output prior to making API calls in wait-for-migration commands
• Support forked repositories in Bitbucket Server migrations

EDIT: Previously, this release note announced a new --skip-invitation flag for reclaim-mannequin to allow EMU organizations to reclaim mannequins without an email invitation. This feature is currently under development, and not yet available for use.

• Include the migration ID in the default output filename when running download-logs
• Include the date with the timestamp when writing to the log
• When blob storage credentials are provided to the CLI but will not be used for a GHES migration, log a clear warning, not an info message
• Fix support for Azure Blob Storage in bbs2gh migrations when the archive is larger than 2GB
• Unhide the --archive-download-host argument in the documentation for gh bbs2gh migrate-repo and gh bbs2gh generate-script

• migrate-repo commands now take a --target-repo-visibility flag ("public", "private", or "internal"; defaults to "private") to set the visibility of the imported repo
• gh gei generate-script will now inspect the source repo visibility and add the appropriate --target-repo-visibility flag to the generated script. ado2gh generate-script and bbs2gh generate-script will include the --target-repo-visibility flag in the generated script but it will always be set to private.