Docker コンテナーのアクションを作成する

このチュートリアルでは、Docker コンテナー アクションを構築する方法について説明します。

この記事で

メモ

GitHub ホステッド ランナーは、現在 GitHub Enterprise Server ではサポートされていません。

はじめに

このガイドでは、パッケージ化されたDockerコンテナのアクションを作成して使うために必要な、基本的コンポーネントについて学びます。 アクションのパッケージ化に必要なコンポーネントのガイドに焦点を当てるため、アクションのコードの機能は最小限に留めます。 アクションでは、ログに "Hello World" が出力されます。カスタム名を指定した場合は "Hello [who-to-greet]" が出力されます。

このプロジェクトを完了すると、あなたの Docker コンテナのアクションをビルドして、ワークフローでテストする方法が理解できます。

セルフホストランナーでDockerコンテナアクションを実行するためには、Linuxオペレーティングシステムを使い、Dockerがインストールされていなければなりません。 自己ホストランナーの要件の詳細については、「セルフホステッド ランナー」を参照してください。

データ 再利用可能なアクション.コンテキスト挿入警告 %}

前提条件

Dockerfileの作成

新しい hello-world-docker-action ディレクトリに、新しい Dockerfile ファイルを作成します。 問題が発生する場合は、ファイル名で大文字が正しく使用されていることを確認します (D は大文字にしますが、f は大文字にしません)。 詳しくは、「GitHub ActionsのためのDockerfileサポート」をご覧ください。

          **Dockerfile**
Dockerfile
# Container image that runs your code
FROM alpine:3.10

# Copies your code file from your action repository to the filesystem path `/` of the container
COPY entrypoint.sh /entrypoint.sh

# Code file to execute when the docker container starts up (`entrypoint.sh`)
ENTRYPOINT ["/entrypoint.sh"]

アクションのメタデータファイルの作成

上で作成した action.yml ディレクトリに新しい hello-world-docker-action ファイルを作成します。 詳しくは、「メタデータ構文リファレンス」をご覧ください。

action.yml

YAML
# action.yml
name: 'Hello World'
description: 'Greet someone and record the time'
inputs:
  who-to-greet:  # id of input
    description: 'Who to greet'
    required: true
    default: 'World'
outputs:
  time: # id of output
    description: 'The time we greeted you'
runs:
  using: 'docker'
  image: 'Dockerfile'
  args:
    - ${{ inputs.who-to-greet }}

このメタデータで、1 つの who-to-greet 入力と 1 つの time 出力パラメーターを定義します。 入力を Docker コンテナーに渡すには、inputs を使用して入力を宣言し、args キーワードで入力を渡す必要があります。 args に含めたすべてのものがコンテナーに渡されますが、アクションのユーザーにわかりやすいよう、inputs を使用することをお勧めします。

GitHub によって Dockerfile からイメージがビルドされ、このイメージを使用して新しいコンテナーでコマンドが実行されます。

アクションのコードの記述

任意のベース Docker イメージを選択できるので、アクションに任意の言語を選択できます。 次のシェル スクリプトの例では、who-to-greet 入力変数を使って、ログ ファイルに "Hello [who-to-greet]" と出力されます。

次に、スクリプトは現在の時刻を取得し、それをジョブ内で後に実行するアクションが利用できる出力変数に設定します。 GitHub が出力変数を認識するには、それらを$GITHUB_OUTPUT環境ファイルecho "<output name>=<value>" >> $GITHUB_OUTPUTに書き込む必要があります。 詳しくは、「GitHub Actions のワークフロー コマンド」をご覧ください。

  1.        `entrypoint.sh` ディレクトリに新しい `hello-world-docker-action` ファイルを作成します。

  2. 次のコードを entrypoint.sh ファイルに追加します。

           **entrypoint.sh**
    Shell
    #!/bin/sh -l

echo "Hello $1"
time=$(date)
echo "time=$time" >> $GITHUB_OUTPUT


           `entrypoint.sh` がエラーなしで実行された場合、アクションの状態は `success` に設定されます。 アクションのコード中で明示的に終了コードを設定して、アクションのステータスを提供することもできます。 詳しくは、「[AUTOTITLE](/actions/creating-actions/setting-exit-codes-for-actions)」をご覧ください。

  3.        `entrypoint.sh` ファイルを実行可能にします。 Git では、クローンやフォークがあるたびにリセットされないように、ファイルのアクセス許可モードを明示的に変更する方法が用意されています。
    Shell
    git add entrypoint.sh
git update-index --chmod=+x entrypoint.sh

  4. 必要に応じて、Git インデックス内のファイルのアクセス許可モードを確認するには、次のコマンドを実行します。

    Shell
    git ls-files --stage entrypoint.sh

           `100755 e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 0       entrypoint.sh` のような出力は、ファイルに実行可能なアクセス許可があることを意味します。 この例では、`755` が実行可能なアクセス許可を示しています。

READMEの作成

アクションの使用方法を説明するために、README ファイルを作成できます。 README はアクションの公開を計画している時に非常に役立ちます。また、アクションの使い方をあなたやチームが覚えておく方法としても優れています。

          `hello-world-docker-action` ディレクトリに、次の情報を指定する `README.md` ファイルを作成します。

  • アクションの動作に関する詳細な説明。

  • 必須の入力および出力の引数。

  • 省略可能な入力および出力の引数。

  • アクションで使用されるシークレット。

  • アクションで使用される環境変数。

  • ワークフローでのアクションの使用方法の例。

            **README.md**
Markdown
# Hello world docker action

This action prints "Hello World" or "Hello" + the name of a person to greet to the log.

## Inputs

## `who-to-greet`

**Required** The name of the person to greet. Default `"World"`.

## Outputs

## `time`

The time we greeted you.

## Example usage

uses: actions/hello-world-docker-action@v2
with:
  who-to-greet: 'Mona the Octocat'

アクションをコミットし、タグを付けて、プッシュする

お使いのターミナルから、action.yml、entrypoint.sh、Dockerfile、README.md の各ファイルをコミットします。

アクションのリリースにはバージョンタグを加えることもベストプラクティスです。 アクションのバージョン管理の詳細については、「カスタム アクションについて」を参照してください。

Shell
git add action.yml entrypoint.sh Dockerfile README.md
git commit -m "My first action is ready"
git tag -a -m "My first action release" v1
git push --follow-tags

ワークフローでアクションをテストする

これで、ワークフローでアクションをテストできるようになりました。

  • アクションがプライベート リポジトリにある場合は、アクセスできるユーザーを制御できます。 詳しくは、「リポジトリのGitHub Actions設定の管理」をご覧ください。
  • アクションが内部リポジトリにある場合は、アクセスできるユーザーを制御できます。 詳細については、「リポジトリのGitHub Actions設定の管理」を参照してください。
  • パブリック アクションは、任意のリポジトリ内のワークフローで使用できます。

メモ

GitHub Enterprise Server での GitHub Actions は、GitHub.com または GitHub Marketplace でのアクションへのアクセスを制限されている場合があります。 詳細については、「GitHub.com からのアクションへのアクセスの管理」を参照し、GitHub Enterprise のサイト管理者に問い合わせてください。

パブリックアクションを使用する例

次のワークフロー コードでは、パブリックの __ リポジトリにある完全な actions/hello-world-docker-action アクションを使用します。 次のワークフローの例のコードを .github/workflows/main.yml ファイルにコピーしますが、actions/hello-world-docker-action を実際のリポジトリとアクション名に置き換えてください。 who-to-greet 入力を自分の名前に置き換えることもできます。

          **.github/workflows/main.yml**
YAML
on: [push]

jobs:
  hello_world_job:
    runs-on: ubuntu-latest
    name: A job to say hello
    steps:
      - name: Hello world action step
        id: hello
        uses: actions/hello-world-docker-action@v2
        with:
          who-to-greet: 'Mona the Octocat'
      # Use the output from the `hello` step
      - name: Get the output time
        run: echo "The time was ${{ steps.hello.outputs.time }}"

プライベートアクションを使用する例

次の例のワークフロー コードを、アクションのリポジトリ内の .github/workflows/main.yml ファイルにコピーします。 who-to-greet 入力を自分の名前に置き換えることもできます。

          **.github/workflows/main.yml**
YAML
on: [push]

jobs:
  hello_world_job:
    runs-on: ubuntu-latest
    name: A job to say hello
    steps:
      # To use this repository's private action,
      # you must check out the repository
      - name: Checkout
        uses: actions/checkout@v5
      - name: Hello world action step
        uses: ./ # Uses an action in the root directory
        id: hello
        with:
          who-to-greet: 'Mona the Octocat'
      # Use the output from the `hello` step
      - name: Get the output time
        run: echo "The time was ${{ steps.hello.outputs.time }}"

リポジトリから [アクション] タブをクリックして、最新のワークフロー実行を選択します。 [ジョブ] または視覚化グラフで、"A job to say hello" をクリックします。

Hello world action step をクリックすると、"Hello Mona the Octocat" またはログに出力されている who-to-greet に入力した名前が表示されます。 タイムスタンプを表示するには、 [出力時刻の取得] をクリックします。

コンテナー アクションで作成したファイルへのアクセス

コンテナー アクションを実行する、ランナーの既定の作業ディレクトリ (GITHUB_WORKSPACE) がコンテナー上の /github/workspace ディレクトリに自動的にマップされます。 コンテナーのこのディレクトリに追加されたファイルは、同じジョブ内の後続のステップで使用できます。 たとえば、プロジェクトをビルドするコンテナー アクションがあり、ビルド出力を成果物としてアップロードする場合は、次の手順を使用できます。

          **workflow.yml**
YAML
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v5

      # Output build artifacts to /github/workspace on the container.
      - name: Containerized Build
        uses: ./.github/actions/my-container-action

      - name: Upload Build Artifacts
        uses: actions/upload-artifact@v3
        with:
          name: workspace_artifacts
          path: ${{ github.workspace }}

ビルド出力を成果物としてアップロードする方法の詳細については、「ワークフロー成果物を使ったデータの格納と共有」を参照してください。

GitHub.com

に対する Docker コンテナー アクションの例

Docker コンテナー アクションの例は、GitHub.com に多数あります。

  •         [github/issue-metrics](https://github.com/github/issue-metrics)

  •         [microsoft/infersharpaction](https://github.com/microsoft/infersharpaction)

  •         [microsoft/ps-docs](https://github.com/microsoft/ps-docs)