ワークフロー、シークレット、ランナーを Organization と共有する

スターターワークフロー、シークレット、変数、セルフホストランナーを共有することで、組織の機能を使用してチームと共同作業する方法を説明します。

この記事の内容

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

概要

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

アクションとワークフローの共有

個々のアクションとワークフロー全体の両方を、アクションまたはワークフローを公開するかどうかにかかわらず、Organization と共有できます。ワークフローファイルでアクションとワークフローを参照することで、アクションとワークフローを正確に再利用できます。また、新しいワークフローのテンプレートを提供するスターターワークフローを作成できます。

アクションを公開せずにエンタープライズ全体でアクションを共有するには、内部リポジトリにアクションを格納し、同じ組織またはエンタープライズ内の任意の組織が所有する他のリポジトリ内の GitHub Actions ワークフローへのアクセスを許可するようにリポジトリを構成します。詳しくは、「アクションとワークフローを企業と共有する」を参照してください。

ワークフローの再利用

ワークフローを公開または非公開で自分の組織と共有するために、あるワークフローを別のワークフロー内から呼び出すことができます。このようにすると、ワークフローを再利用し、重複を回避し、ワークフローのメンテナンスを簡単にすることができます。詳しくは、「ワークフローの再利用」を参照してください。

スターターワークフローを使用する

スターターワークフローを使用すると、ワークフローを作成するアクセス許可を持つ Organization 内のすべての人が、より迅速かつ簡単にワークフローを作成できます。新しいワークフローを作成する場合は、スターターワークフローを選択すると、ワークフローを作成する作業の一部またはすべてを自動的に行うことができます。スターターワークフローは、カスタムワークフローの構築の出発点として利用することも、そのまま利用することもできます。これにより、時間を節約できるだけでなく、Organization 全体の一貫性とベストプラクティスが促進されます。詳しくは、「Organization のスターターワークフローを作成する」をご覧ください。

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

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

Organization のオーナーは、Organization レベルでシークレットまたは変数を作成できます。

お使いの GitHub Enterprise Server インスタンスで、Organization のメインページへ移動します。
組織名の下で、 [設定] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。
サイドバーの [セキュリティ] セクションで、 [ シークレットと変数] を選択し、次に [アクション] をクリックします。
[シークレット] タブまたは [変数] タブをクリックし、目的の値とオプションを使ってシークレットまたは変数を作成します。

詳細については、「GitHub Actions でのシークレットの使用」または「変数」を参照してください。

組織のオーナーは、自社でホストしているランナーをグループに追加し、どのリポジトリがグループにアクセスできるかを制御するポリシーを作成することができます。

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

次の手順

GitHub Actions についてさらに学ぶには、「Organization のスターターワークフローを作成する」をご覧ください。