インストール方法

ecspressoは、様々な方法でインストールできます。ここでは、各プラットフォームでのインストール方法を説明します。

Homebrew（macOSとLinux）

macOSとLinuxでは、Homebrewを使用して簡単にインストールできます。

$ brew install kayac/tap/ecspresso

asdf（macOSとLinux）

asdfは、複数のランタイムバージョンを管理するためのツールです。

$ asdf plugin add ecspresso
# または
$ asdf plugin add ecspresso https://github.com/kayac/asdf-ecspresso.git

$ asdf install ecspresso 2.3.0
$ asdf global ecspresso 2.3.0

aqua（macOSとLinux）

aquaは、CLIバージョン管理ツールです。

$ aqua g -i kayac/ecspresso

バイナリパッケージ

GitHubのリリースページから、各プラットフォーム向けのバイナリパッケージをダウンロードできます。

  1. リリースページから、お使いのプラットフォーム（Linux、macOS、Windows）に合ったバイナリをダウンロード
  2. ダウンロードしたファイルを解凍
  3. 実行可能ファイルをPATHの通ったディレクトリに配置

CircleCI Orbs

CircleCIでecspressoを使用する場合は、Orbsを利用できます。

version: 2.1
orbs:
  ecspresso: fujiwara/ecspresso@2.0.4
jobs:
  install:
    steps:
      - checkout
      - ecspresso/install:
          version: v2.3.0 # または latest
          # version-file: .ecspresso-version
          os: linux # または windows または darwin
          arch: amd64 # または arm64
      - run:
          command: |
            ecspresso version

version: latestを指定すると、Orbのバージョンに応じて異なるバージョンのecspressoがインストールされます。

  • fujiwara/ecspresso@0.0.15
    • 最新のリリースバージョン（v2以降）
  • fujiwara/ecspresso@1.0.0
    • v1.xの最新バージョン
  • fujiwara/ecspresso@2.0.3
    • v2.xの最新バージョン

注意: version: latestは、新しいバージョンのecspressoがリリースされたときに予期しない動作を引き起こす可能性があるため、推奨されません。

Orb fujiwara/ecspresso@2.0.2以降は、version-file: path/to/fileをサポートしており、ファイルで指定されたecspressoのバージョンをインストールします。このバージョン番号にはvプレフィックスはありません（例：2.0.0）。

GitHub Actions

GitHub Actionsでecspressoを使用する場合は、Action kayac/ecspresso@v2を利用できます。このアクションは、Linux(x86_64)用のecspressoバイナリを/usr/local/binにインストールします。

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: kayac/ecspresso@v2
        with:
          version: v2.3.0 # または latest
          # version-file: .ecspresso-version
      - run: |
          ecspresso deploy --config ecspresso.yml

最新バージョンのecspressoを使用するには、パラメータ「latest」を渡します。

      - uses: kayac/ecspresso@v2
        with:
          version: latest

version: latestを指定すると、Actionのバージョンに応じて異なるバージョンのecspressoがインストールされます。

  • kayac/ecspresso@v1
    • v1.xの最新バージョン
  • kayac/ecspresso@v2
    • v2.xの最新バージョン

注意: version: latestは、新しいバージョンのecspressoがリリースされたときに予期しない動作を引き起こす可能性があるため、推奨されません。

Action kayac/ecspresso@v2は、version-file: path/to/fileをサポートしており、ファイルで指定されたecspressoのバージョンをインストールします。このバージョン番号にはvプレフィックスはありません（例：2.3.0）。

バージョン確認

インストール後、以下のコマンドでecspressoのバージョンを確認できます。

$ ecspresso version
ecspresso 2.3.0

次のステップ