Skip to content
spacelift-io

GitHub Action

Setup Spacectl

v1.4.0 Latest version

Setup Spacectl

spacelift-io

Setup Spacectl

This action installs the Spacectl CLI tool and adds it to the PATH.

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Setup Spacectl

uses: spacelift-io/[email protected]

Learn more about this action in spacelift-io/setup-spacectl

Choose a version

setup-spacectl

build code style: prettier

This is a simple GitHub Action to install spacectl: a utility wrapping Spacelift's GraphQL API for easy programmatic access in command-line contexts - either in manual interactive mode (in your local shell), or in a predefined CI pipeline (GitHub Actions, CircleCI, Jenkins etc).

✨ Usage

Note that the action queries the GitHub API to list the available releases of spacectl so it needs a GitHub token. By default it uses ${{ github.token }} but you can override it by setting the github-token input.

steps:
  - name: Install spacectl
    uses: spacelift-io/setup-spacectl@v1

  - name: Deploy infrastructure
    env:
      SPACELIFT_API_KEY_ENDPOINT: https://mycorp.app.spacelift.io
      SPACELIFT_API_KEY_ID: ${{ secrets.SPACELIFT_API_KEY_ID }}
      SPACELIFT_API_KEY_SECRET: ${{ secrets.SPACELIFT_API_KEY_SECRET }}
    run: spacectl stack deploy --id my-infra-stack

You can optionally provide a specific version:

steps:
  - name: Install spacectl
    uses: spacelift-io/setup-spacectl@v1
    with:
      version: v0.18.0

Inputs

Name Description Default
version Which version of spacectl to install. If not specified, the latest version will be installed (recommended). latest
github-token The GitHub token to use for querying the GitHub API. ${{ github.token }}

Outputs

Name Description
version The version of spacectl that was installed.

🛠 Contributing

Contributions are welcome! Three tips.

  • If you edited a file in ./src folder, make sure you format it with npm run format and build it with npm run build. The Action uses the output of the build (dist/index.js) as its entry point so contributors must manually build it.

  • If you use VS Code, it's recommended to install the Prettier extension to automatically format your code on save.

  • In order to have a nice changelog in the release section, please follow the Conventional Commits specification.