Creating a composite action

注: GitHub ホステッドランナーは、現在 GitHub Enterprise Server でサポートされていません。 GitHub public roadmap で、今後の計画的なサポートの詳細を確認できます。

Introduction

In this guide, you'll learn about the basic components needed to create and use a packaged composite action. To focus this guide on the components needed to package the action, the functionality of the action's code is minimal. The action prints "Hello World" and then "Goodbye", or if you provide a custom name, it prints "Hello [who-to-greet]" and then "Goodbye". The action also maps a random number to the random-number output variable, and runs a script named goodbye.sh.

Once you complete this project, you should understand how to build your own composite action and test it in a workflow.

警告: ワークフローとアクションを作成するときは、コードが攻撃者からの信� �されていない入力を実行する可能性があるかどうかを常に考慮する必要があります。攻撃者が悪意あるコンテンツを挿入してくるかもしれないので、特定のコンテキストは信� �できない入力として扱うべきです。詳細については、「スクリプトインジェクションのリスクについて」を参照してく� さい。

Prerequisites

Before you begin, you'll create a repository on your GitHub Enterprise Server instance.

Create a new public repository on your GitHub Enterprise Server instance. You can choose any repository name, or use the following hello-world-composite-action example. You can add these files after your project has been pushed to GitHub Enterprise Server. For more information, see "Create a new repository."
Clone your repository to your computer. For more information, see "Cloning a repository."
From your terminal, change directories into your new repository.
```
cd hello-world-composite-action
```
In the hello-world-composite-action repository, create a new file called goodbye.sh, and add the following example code:
```
echo "Goodbye"
```
From your terminal, make goodbye.sh executable.
```
chmod +x goodbye.sh
```

From your terminal, check in your goodbye.sh file.

git add goodbye.sh
git commit -m "Add goodbye script"
git push

Creating an action metadata file

In the hello-world-composite-action repository, create a new file called action.yml and add the following example code. For more information about this syntax, see "runs for a composite actions".

action.yml

name: 'Hello World'
description: 'Greet someone'
inputs:
  who-to-greet:  # id of input
    description: 'Who to greet'
    required: true
    default: 'World'
outputs:
  random-number:
    description: "Random number"
    value: ${{ steps.random-number-generator.outputs.random-number }}
runs:
  using: "composite"
  steps:
    - run: echo Hello ${{ inputs.who-to-greet }}.
      shell: bash
    - id: random-number-generator
      run: echo "::set-output name=random-number::$(echo $RANDOM)"
      shell: bash
    - run: echo "${{ github.action_path }}" >> $GITHUB_PATH
      shell: bash
    - run: goodbye.sh
      shell: bash

This file defines the who-to-greet input, maps the random generated number to the random-number output variable, and runs the goodbye.sh script. It also tells the runner how to execute the composite action.

For more information about managing outputs, see "outputs for a composite action".

For more information about how to use github.action_path, see "github context".

From your terminal, check in your action.yml file.

git add action.yml
git commit -m "Add action"
git push

From your terminal, add a tag. This example uses a tag called v1. For more information, see "About actions."
```
git tag -a -m "Description of this release" v1
git push --follow-tags
```

Testing out your action in a workflow

The following workflow code uses the completed hello world action that you made in "Creating an action metadata file".

Copy the workflow code into a .github/workflows/main.yml file in another repository, but replace actions/hello-world-composite-action@v1 with the repository and tag you created. You can also replace the who-to-greet input with your name.

.github/workflows/main.yml

on: [push]

jobs:
  hello_world_job:
    runs-on: ubuntu-latest
    name: A job to say hello
    steps:
      - uses: actions/checkout@v2
      - id: foo
        uses: actions/hello-world-composite-action@v1
        with:
          who-to-greet: 'Mona the Octocat'
      - run: echo random-number ${{ steps.foo.outputs.random-number }}
        shell: bash

From your repository, click the Actions tab, and select the latest workflow run. The output should include: "Hello Mona the Octocat", the result of the "Goodbye" script, and a random number.

Creating a composite action

この記事では、次の� �目が扱われます。

Introduction

Prerequisites

Creating an action metadata file

Testing out your action in a workflow