Ionic Cloud CLI
This feature is only available on our Standard or Enterprise plans. Please contact us to enable this feature.
All of Ionic's cloud products can be used inside your own CI/CD platform (such as Azure DevOps, Gitlab, Jenkins, and more) through the use of our Ionic Cloud CLI.
What/who is the Ionic Cloud CLI for?
Ionic Cloud CLI allows enterprises with their own CI/CD platforms to have granular control of Appflow within their existing pipelines. Rather than setting up automations using Appflow Automations, enterprises can utilize the CLI to control exactly when builds are produced and deployed, so they insert their own processes in between these steps (e.g. code signing, QA testing, manager approvals, etc.)
To install, run the following command
curl -fsSL https://ionic.io/get-ionic-cloud-cli | bash
Locking the Ionic Cloud CLI Version
If you'd like to lock the version of Ionic Cloud CLI in place for your pipeline, use the following command to install the Ionic Cloud CLI instead, replacing
X.X.X with your desired version number:
export IONIC_CLOUD_VERSION=X.X.X; curl -fsSL https://ionic.io/get-ionic-cloud-cli | bash
Before you use the Ionic Cloud CLI you'll first need a Personal Access Token, then you can follow along with the CLI documentation for the individual product that you'd like to use.
Once you have your token, you can authenticate the Ionic Cloud CLI by setting the token to an environment variable in you CI/CD system.
or you can create an Ionic Cloud CLI config file:
and run your commands from the directory the file is in, or by specifying the location with the
Before using the Ionic Cloud CLI, you must set up a Personal Access Token to authenticate with Ionic.
Update your app remotely in real-time using your own CI/CD pipelines.
Build app binaries in the cloud for iOS and Android, even on your linux CI/CD runner.
Publish directly to the iOS App Store and Google Play Store from your own CI/CD platform in one command.
Why a separate CLI?
It was a difficult decision, but ultimately we decided to split Cloud related CLI commands into its own CLI for three reasons:
1) Simplification of CLIs. Ionic Framework and Capacitor commands make sense to have under one roof because they both serve the same use case (assisting a developer while they are developing), however the Cloud related commands serve a completely different use case (allowing an external CI/CD system to control when builds or deployments are made).
2) Reduce installation size. Ionic CLI requires node (and npm) to install. For development, a user would already have those installed, however for a CI/CD system interacting with Appflow, a dependency like Node may be completely unnecessary and causes pipelines to take longer and use more resources. Ionic Cloud CLI is installed in one command and is around 10 MB in size.
3) Better DevOps practices. We used moving to a separate CLI to increase clarity in the names of the commands and
their function for more granular control of your DevOps pipeline e.g.
deploy/package build to