Skip to content
tidbcloud

GitHub Action

Set up tidbcloud cli

v0.2.0 Latest version

Set up tidbcloud cli

tidbcloud

Set up tidbcloud cli

Downloads, installs, and configures a `ticloud` environment. Adds the `ticloud` CLI command to the $PATH

Installation

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

              

- name: Set up tidbcloud cli

uses: tidbcloud/setup-tidbcloud-cli@v0.2.0

Learn more about this action in tidbcloud/setup-tidbcloud-cli

Choose a version

setup-tidbcloud-cli

The tidbcloud/setup-tidbcloud-cli action is a JavaScript action that sets up ticloud in your GitHub Actions workflow by:

  • Downloading a specific version of ticloud and adding it to the PATH.
  • Configuring ticloud with API token.

Prerequisites

  • This action requires TiDB Cloud API Key to execute ticloud commands. See Authentication for more details.
  • This action only support following runners:
Architecture Support macOS Linux Windows
arm64
amd64

Usage

This action can be run on ubuntu-latest, windows-latest, and macos-latest GitHub Actions runners. When running on windows-latest the shell should be set to Bash. See Prerequisites on how to get API key and then set them to repository secrets.

uses: tidbcloud/setup-tidbcloud-cli@v0
with:
  api_public_key: ${{ secrets.TIDB_CLOUD_API_PUBLIC_KEY }}
  api_private_key: ${{ secrets.TIDB_CLOUD_API_PRIVATE_KEY }}

A specific version of ticloud can be installed(Releases can be found here):

uses: tidbcloud/setup-tidbcloud-cli@v0
with:
  version: 0.1.6
  api_public_key: ${{ secrets.TIDB_CLOUD_API_PUBLIC_KEY }}
  api_private_key: ${{ secrets.TIDB_CLOUD_API_PRIVATE_KEY }}

Inputs

The action supports the following inputs:

  • api_public_key - (required) The public key of TiDB Cloud api.
  • api_private_key - (required) The private key of TiDB Cloud api.
  • version - (optional) The version of ticloud to install, defaulting to latest version.

License

See LICENSE.