業務で実際に使っているActionsを利用例込で挙げてみた

Composite Run Stepsに合わせて全体で利用しているActionの見直しと整理を行っていました。元々最低限使うもののみという状態で、見直しても1部除いて特に増えることもなく。

業務で実際に使っているものを利用例合わせて挙げてみるのも需要は多少あるかなと思い、まとめてみました。

必需

Actionsを使う以上は利用が避けられないと思われるシリーズ。

actions/checkout

ソースコードのチェックアウトをしてくれます。ssh設定を引数として受け付けてくれるため、run で git checkout をするよりも手間が省けます。

- uses: actions/checkout@v2
  with:
    repository: my-org/my-tools
    path: my-tools

actions/setup-python

Pythonのセットアップをしてくれます。バージョンやアーキテクチャの指定を受け付けることや、バージョンを範囲で指定するとその中で最新有効なバージョンを自動設定してくれるなど、自前でインストールするよりも便利です。

- uses: actions/setup-python@v2
  with:
    python-version: '3.9.0-alpha - 3.9.0' # SemVer's version range syntax

普通はバージョン決め打ちになるでしょうが、使い方によっては公式リポジトリに乗っているように以下のようなことも可能です。

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version:
        - 'pypy-3.6' # the latest available version of PyPy that supports Python 3.6
        - 'pypy-3.7' # the latest available version of PyPy that supports Python 3.7
        - 'pypy-3.7-v7.3.3' # Python 3.7 and PyPy 7.3.3
    steps:
    - uses: actions/checkout@v2
    - uses: actions/setup-python@v2
      with:
        python-version: ${{ matrix.python-version }}

actions/setup-java

setup-python のjava版といった感じ。ポイントはdistributionが選択可能なところ。MarketplaceのURLがsetup-java-jdkなのもポイントです。

- uses: actions/setup-java@v2
  with:
    distribution: 'adopt'
    java-version: '11'
    check-latest: true

actions/setup-node

nodejs版。MarketplaceのURLはsetup-node-js-environmentです。

- uses: actions/setup-node@v2
  with:
    node-version: '14'

actions/cache

Actionsの実行時間短縮には助かりもの。keyの指定が理解するまで間違いやすいことと、言語毎のライブラリ一時キャッシュ先について予め仕組みを理解しておく必要があります。

- uses: actions/cache@v2
  with:
    path: |
      ~/cache
      !~/cache/exclude
    key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }}

unfor19/install-aws-cli-action

awscliをv1からv2に移行する際の検証時には使って損をしません。

本番リリース用

Release時のTag追加やDeploy通知で役立つActionです。

mathieudutour/github-tag-action

現在最新のtagに対してインクリメント後のバージョンを返します。

    - name: Bump version and push tag
      id: tag_version
      uses: mathieudutour/github-tag-action@v5
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        default_bump: "minor"

actions/create-release

指定したtagにてreleaseを作成します。mathieudutour/github-tag-actionとの組み合わせで用いる事が多いかもしれません。

    - name: Publish release
      uses: actions/create-release@v1
      env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      with:
        tag_name: ${{ steps.tag_version.outputs.new_tag }}
        release_name: Release ${{ steps.tag_version.outputs.new_tag }}
        draft: false
        prerelease: false

chrnorm/deployment-action

DeploymentAPIのステータスを更新します。SlackBot等の通知指定を設定済みであれば、更新時に自動で通知されます。

    - uses: chrnorm/deployment-action@releases/v1
      name: Create GitHub deployment
      id: deployment
      with:
        token: "${{ github.token }}"
        environment: "${{ env.ENVIRONMENT }}"
        description: "${{ env.COMMIT_MESSAGE }}"

    - name: Update deployment status (in_progress)
      uses: chrnorm/deployment-status@releases/v1
      with:
        token: "${{ github.token }}"
        state: "in_progress"
        description: "Start deploy"
        deployment_id: ${{ steps.deployment.outputs.deployment_id }}

補助

動作確認の手間を省きたい時等。

haya14busa/action-cond

Composite run stepsにて条件によって値の変更を行う時に利用してみました。シェルスクリプトでのデバッグ時間を割愛したい時には役立ちます。

    - uses: haya14busa/action-cond@v1
      id: update-pipenv-cache-key
      with:
        cond: ${{ inputs.pipenv-cache-key == null }}
        if_true: "pipenv-cache-key=${{ runner.os }}-python-${{ env.python-version }}-pipenv-${{ env.pipenv-version }}-airflow-${{ hashFiles('airflow/Pipfile.lock') }}"
        if_false: "${{ inputs.pipenv-cache-key }}"

あとがき

現時点で利用していたActionを挙げてみました。新しい仕組みを取り入れるというより、runで自力実装する手間を省くタイプのActionが多めです。

Marketplaceで楽になりそうなActionを時折探してはみるものの、大きくWorkflowの組み方が変わるようなActionが出てくることはそうありません。また、ツールをインストールするタイプのActionはツール自体がhost runner側で初期インストールされていくこともあるため、定期的に本当に必要なActionかどうか確認も大事です。