ワークフローを Organization と共有する

ワークフローテンプレート、シークレット、およびセルフホストランナーを共有することで、Organization 機能を使用して Team とコラボレーションする方法を学びます。

ここには以下の内容があります:

概要
ワークフローテンプレートの作成
Organization のワークフローテンプレートを使用する
Organization 内でシークレットを共有する
Organization 内でセルフホストランナーを共有する
次のステップ

ワークフローやその他の GitHub Actions 機能を Team と共有する必要がある場合は、GitHub Organization 内でのコラボレーションを検討します。 Organization を使用すると、シークレット、成果物、およびセルフホストランナーを一元的に保存および管理できます。 .github リポジトリにワークフローテンプレートを作成して、Organization 内の他のユーザと共有することもできます。

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

ワークフローテンプレートは、Organizationの .github リポジトリへの書き込みアクセス権を持つユーザが作成できます。その後、ワークフローを作成する権限を持つOrganizationのメンバーがテンプレートを使用できます。ワークフローテンプレートを使用すると、Organizationのパブリックリポジトリに新しいワークフローを作成できます。テンプレートを使用してプライベートリポジトリにワークフローを作成するには、OrganizationがエンタープライズプランまたはGitHub Oneプランの一部である必要があります。

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

存在しない場合は、Organization内で.githubという名前の新しいパブリックリポジトリを作成します。
workflow-templatesという名前のディレクトリを作成します。
workflow-templates ディレクトリ内に新しいワークフローファイルを作成します。

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

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

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

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v2

      - 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という名前のワークフローファイルのメタデータが含まれています。
```
{
    "name": "Octo Organization Workflow",
    "description": "Octo Organization CI workflow template.",
    "iconName": "example-icon",
    "categories": [
        "Go"
    ],
    "filePatterns": [
        "package.json$",
        "^Dockerfile",
        ".*\\.md$"
    ]
}
```
- name - 必須。 ワークフローテンプレートの名前。これは、使用可能なテンプレートの一覧に表示されます。
- description - 必須。 ワークフローテンプレートの説明。これは、使用可能なテンプレートの一覧に表示されます。
- iconName - 必須。 テンプレートリスト内のワークフローのエントリのアイコンを定義します。 iconName は、同じ名前の SVG アイコンである必要があり、 workflow-templates ディレクトリに格納する必要があります。たとえば、example-icon.svgという名前の SVG ファイルは、 example-iconとして参照されます。
- categories - オプション。 ワークフローの言語カテゴリを定義します。ユーザーが使用可能なテンプレートを表示する際に、同じ言語に一致するテンプレートが目立つようにになります。使用可能な言語カテゴリについては、「https://github.com/github/linguist/blob/master/lib/linguist/languages.yml」を参照してください。
- filePatterns - オプション。 定義された正規表現に一致するファイルがユーザーのリポジトリのルートディレクトリにある場合に、テンプレートを使用できるようにします。

別のワークフローテンプレートを追加するには、同じ workflow-templates ディレクトリにファイルを追加します。例:

ワークフローテンプレートファイル

Organization のワークフローテンプレートを使用する

この手順では、Organizationのメンバーがワークフローテンプレートを検索して利用し、新しいワークフローを作成する方法を示します。 Organizationのワークフローテンプレートは、Organizationのメンバーであるすべてのユーザーが使用できます。

GitHubで、リポジトリのメインページにアクセスしてください。
リポジトリ名の下でActions（アクション）をクリックしてください。
リポジトリに既存のワークフローが既に存在する場合: 左上隅にある [New workflow（新しいワークフロー）] をクリックします。
Organizationのワークフローテンプレートは、「Organizationの名前によって作成されたワークフロー」というタイトルの独自セクションにあります。使いたいテンプレート名の下で、Set up this workflow（このワークフローをセットアップする）をクリックしてください。

Organization 内でシークレットを一元管理し、選択したリポジトリで使用できるようにすることができます。これは、1 つの場所でシークレットを更新し、その変更をシークレットを使用するすべてのリポジトリワークフローに適用できるということを示します。

Organizationでシークレットを作成する場合、ポリシーを使用して、そのシークレットにアクセスできるリポジトリを制限できます。たとえば、すべてのリポジトリにアクセスを許可したり、プライベートリポジトリまたは指定したリポジトリのリストのみにアクセスを制限したりできます。

Organizationのレベルでシークレットを作成するには、管理アクセス権を持っていなければなりません。

GitHubで、Organizationのメインページにアクセスしてください。
Organization名の下で、Settings（設定）をクリックしてください。
左サイドバーで [Secrets] をクリックします。
[New secret（新しいシークレット）] をクリックします。
[Name（名前）] 入力ボックスにシークレットの名前を入力します。
シークレットの Value（値） を入力します。
[ Repository access（リポジトリアクセス） ドロップダウンリストから、アクセスポリシーを選択します。
[Add secret（シークレットの追加）] をクリックします。

Organization の管理者は、セルフホストランナーをグループに追加してから、グループにアクセスできるリポジトリを制御するポリシーを作成できます。

詳しい情報については、「グループを使用したセルフホストランナーへのアクセスを管理する」を参照してください。

次のステップ

GitHub Actions の詳細については、「GitHub Actions のセキュリティ強化」を参照してください。

ワークフローを Organization と共有する

ここには以下の内容があります: