asc CircleCI Orb

GitHub-released source preview CircleCI orb for asc (App Store Connect CLI).

Use this orb to install asc, configure secure App Store Connect API authentication, and automate iOS/TestFlight release workflows in CircleCI.

Publication status

This repository has a GitHub source release, but it is not published as a CircleCI Registry orb yet. Treat the registry name rudrankriyam/asc and every rudrankriyam/asc@1.0.1 snippet below as pending Registry publication, not an install path that works today.

Why use this orb

• Optimized installer for asc release binaries (latest or pinned version)
• Secure auth setup using CircleCI env_var_name parameters
• Reusable commands for App Store Connect automation in CI/CD
• Works in Linux and macOS CircleCI executors

Pending registry example

The example below is the intended shape after the orb is published and tagged. Until then, use the source files for local validation only.

version: 2.1

orbs:
  asc: rudrankriyam/asc@1.0.1

jobs:
  appstore-check:
    docker:
      - image: cimg/base:stable
    steps:
      - asc/install:
          version: latest
      - asc/exec:
          command: asc --help

workflows:
  main:
    jobs:
      - appstore-check

Commands and jobs

• install: Install asc from GitHub release assets
• setup-auth: Export asc authentication environment variables
• exec: Execute a provided asc command string
• smoke job: Install asc and run no-side-effect smoke checks

Security model

• Sensitive values are passed by env var name, not inline secrets
• setup-auth writes exported values to BASH_ENV for subsequent steps
• Optional checksum verification is supported in install

Usage examples

These examples are kept as publication fixtures for a future CircleCI Registry release. They are not proof that a Registry orb exists today.

• Install only
• Setup auth + execute command
• End-to-end smoke workflow
• macOS executor example

Resources

• CircleCI orb docs: https://circleci.com/docs/orbs/author/orb-concepts
• asc CLI: https://github.com/rudrankriyam/App-Store-Connect-CLI

Local development

Prerequisite: CircleCI CLI

circleci orb pack src > orb.yml
circleci orb validate orb.yml

Publishing

• GitHub source release: v1.0.1
• CircleCI Registry publication is still pending
• Dev orb publishes from non-main branches
• Production publishes only on semver tags (vX.Y.Z)
• CircleCI context circleci-orb-publishing must provide publishing token