組織のワークフローテンプレートを作成する

ワークフローテンプレートの作成

この手順では、ワークフローテンプレートとメタデータファイルを作成する方法を示します。メタデータファイルには、ユーザーが新しいワークフローを作成するときに、ワークフローテンプレートがどのように表示されるかが記述されています。

まだ存在しない場合は、組織内にという名前の新しい public .githubrepository を作成します。

       `workflow-templates` という名前のディレクトリを作成します。

       `workflow-templates` ディレクトリ内に新しいワークフロー ファイルを作成します。

リポジトリの既定のブランチを参照する必要がある場合は、$default-branch プレースホルダーを使用できます。ワークフローが作成されるとき、プレースホルダーはリポジトリの既定のブランチの名前に自動的に置き換えられます。

たとえば、octo-organization-ci.yml という名前のこのファイルは、基本的なワークフローを示しています。

YAML

name: Octo Organization CI

on:
  push:
    branches: [ $default-branch ]
  pull_request:
    branches: [ $default-branch ]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v5

      - name: Run a one-line script
        run: echo Hello from Octo Organization

name: Octo Organization CI

on:
  push:
    branches: [ $default-branch ]
  pull_request:
    branches: [ $default-branch ]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v5

      - name: Run a one-line script
        run: echo Hello from Octo Organization

```
       `workflow-templates` ディレクトリ内にメタデータ ファイルを作成します。 メタデータ ファイルは、ワークフロー ファイルと同じ名前にする必要がありますが、`.yml` 拡張子の代わりに、`.properties.json` を付ける必要があります。 たとえば、`octo-organization-ci.properties.json` という名前のこのファイルには、`octo-organization-ci.yml` という名前のワークフロー ファイルのメタデータが含まれます。
```
JSON
```
{
    "name": "Octo Organization Workflow",
    "description": "Octo Organization CI workflow template.",
    "iconName": "example-icon",
    "categories": [
        "Go"
    ],
    "filePatterns": [
        "package.json$",
        "^Dockerfile",
        ".*\\.md$"
    ]
}
```
```
{
    "name": "Octo Organization Workflow",
    "description": "Octo Organization CI workflow template.",
    "iconName": "example-icon",
    "categories": [
        "Go"
    ],
    "filePatterns": [
        "package.json$",
        "^Dockerfile",
        ".*\\.md$"
    ]
}
```
- name - 必須。 ワークフローの名前です。これは、使用可能なワークフローの一覧に表示されます。
- description - 必須。 ワークフローの説明。これは、使用可能なワークフローの一覧に表示されます。
- iconName - 省略可。 ワークフローの一覧に表示されるワークフローのアイコンを指定します。 iconName には、次のいずれかの型を指定できます。
  - workflow-templates ディレクトリに格納されている SVG ファイル。ファイルを参照するには、その値がファイル拡張子のないファイル名である必要があります。たとえば、example-icon.svg という名前の SVG ファイルは example-icon として参照されます。
  - GitHub の Octicons セットからのアイコン。 octicon を参照するには、値を octicon <icon name> にする必要があります。たとえば、「 octicon smiley 」のように入力します。
- categories - 省略可。 ワークフローが表示されるカテゴリを定義します。次の一覧からのカテゴリ名を使用できます。
  - starter-workflows リポジトリの一般的なカテゴリ名。
  - linguist リポジトリの一覧からの Linguist 言語。
  - starter-workflows リポジトリの一覧からのサポートされている技術スタック。
- filePatterns - 省略可。 ユーザーのリポジトリのルートディレクトリに、定義された正規表現に一致するファイルがある場合、そのワークフローを使用できるようにします。
別のワークフローテンプレートを追加するには、同じ workflow-templates ディレクトリにファイルを追加します。

次のステップ

ワークフローテンプレートの参照情報については、「ワークフロー構成の再利用」を参照してください。

組織のワークフロー テンプレートを作成する

この記事で

ワークフロー テンプレートの作成

次のステップ

組織のワークフローテンプレートを作成する

ワークフローテンプレートの作成