Release Bundle Usage & API Reference

This section contains usage and APIs provided by the CLI for releasing a bundle.

Prerequisite:

This command requires a CI Token. It will not function without one and is intended specifically for automated workflows.

Generating a CI Token

Before using the release-bundle command, ensure you have generated a CI token via the Stallion Console by navigating to:
Project Settings > Access Tokens > Generate CI Token

Updating a Release

Once you have a valid CI Token, you can release a previously published bundle using the release-bundle command.

Note: The platform is automatically detected based on the platform specified during the bundle publishing step.

stallion update-release \
  --project-id=<your_project_id> \
  --hash=<bundle_hash> \
  --app-version=<target_app_version> \
  --release-note="Your release note" \
  --ci-token=<your_ci_token>

Example

stallion release-bundle \
  --project-id=64f5f341a43eb5ccf93548e4 \
  --hash=6c8a45dcf5a3e983e389afada81449b2b326b2540758a55ca2227902a55f7e2a \
  --app-version=1.0.1 \
  --release-note="First test CI release" \
  --ci-token=stl_zKNKb6JvW80DemZNomJF8EgxHo-KNcVo_u

Parameters

1. --project-id
Specifies the project ID. You can find this in the Project Settings section of the Stallion Console.

--project-id=your-project-id

2. --hash
The unique hash of the bundle that was published using the publish-bundle command.

--hash=your-bundle-hash

3. --app-version
The target app version that this bundle is associated with. It should match the version of your Android/iOS application.

--app-version=1.0.1

4. --release-note
A short description of what this release contains.

--release-note="your release note"

5. --ci-token
A required token used for CI/CD automation.

--ci-token="your-CI-token"

6. --is-mandatory (Optional, default: false)
Marks the release as mandatory. If not provided, the release is considered optional.

--is-mandatory=true

7. --is-paused (Optional, default: false)
Indicates whether the release should be paused.

--is-paused=true

Note:

Default rollout percent when a bundle is released is 0%. For updating the rollout percent please use update-release command.

Release Automation Using GitHub Actions

To automate the release process using GitHub Actions, refer to the following documentation:
Release Automation using GitHub Actions