@appcircle/appcenter-migration-tool

App Center Migration Tool

The App Center Migration Tool is a CLI utility designed to help App Center users seamlessly transfer their organizations, apps, and testing groups to Appcircle. This tool streamlines the migration process, ensuring a smooth transition between platforms.

Table Of Contents

• Installation Instructions
• Usage Guidelines
  • Command List
• Environment Variables
• Interactive Mode

Installation Instructions

To install the tool globally, simply launch:

npm install -g @appcenter-migration-tool

alternatively, you can install the tool locally:

npm install @appcenter-migration-tool

Usage Guidelines

To get started :

• Follow the installation instructions

• Simply launch the command on your Terminal/Command Line

appcenter-migration-tool

If you have installed it locally, you should run npx appcenter-migration-tool

• Log in to your App Center and Appcircle accounts.

Below is the list of commands currently supported by appcenter-migration-tool tool:

Core Commands

Run appcenter-migration-tool [commandName] --help to view a list of commands/subcommands in your terminal.

• appcenter-migration-tool login
• appcenter-migration-tool organizations
• appcenter-migration-tool apps
• appcenter-migration-tool distribution-groups

The commands follow this pattern:

appcenter-migration-tool <command> <subcommand> ... <subcommand> [options]

• Run appcenter-migration-tool (-i, --interactive) to proceed with the appcenter-migration-tool GUI

Environment Variables

• API_HOSTNAME: Specifies the host where the App Center API endpoint is located.

• APPCENTER_TOKEN: App Center authentication token for API requests. Setting this avoids being prompted to authenticate and overrides any previously stored credentials.

• AC_ACCESS_TOKEN: Appcircle authentication token for API requests. Setting this avoids being prompted to authenticate and overrides any previously stored credentials.

• AC_API_HOSTNAME: Specifies the host where the Appcircle API endpoint is located.

• AC_AUTH_HOSTNAME: Specifies the host where your IAM (identity access management) server endpoint is located.

• AC_PAT: Appcircle Personal Access Token

Interactive Mode

appcenter-migration-tool incorporates a GUI that allows users to interactively access its features. To view all features in interactive mode, execute the following command:

appcenter-migration-tool -i