{"meta":{"title":"codespace の基本イメージを制限する","intro":"Organization 内で作成された新しい codespace の開発コンテナーを作成するために使用できる基本イメージを指定できます。","product":"Codespaces","breadcrumbs":[{"href":"/ja/codespaces","title":"Codespaces"},{"href":"/ja/codespaces/managing-codespaces-for-your-organization","title":"組織の管理"},{"href":"/ja/codespaces/managing-codespaces-for-your-organization/restricting-the-base-image-for-codespaces","title":"基本イメージを制限する"}],"documentType":"article"},"body":"# codespace の基本イメージを制限する\n\nOrganization 内で作成された新しい codespace の開発コンテナーを作成するために使用できる基本イメージを指定できます。\n\n## 概要\n\ncodespace を作成すると、リモート仮想マシンに開発コンテナーが自動的に作成されます。 開発コンテナーは Docker イメージから作成されます。 イメージは実質的に Docker コンテナーのテンプレートであり、codespace によって提供される結果の環境の多くの側面を決定します。 詳しくは、「[GitHub Codespaces のクイックスタート](/ja/codespaces/quickstart#introduction)」をご覧ください。\n\nリポジトリの開発コンテナー構成で指定することで、codespace に使用するイメージを選ぶことができます。 これを行うには、たとえば、`image` ファイルの `devcontainer.json` プロパティを使います。\n\n```json copy\n\"image\": \"mcr.microsoft.com/devcontainers/javascript-node:18\",\n```\n\n詳しくは、開発コンテナーの Web サイトの[開発コンテナーの仕様](https://containers.dev/implementors/json_reference/#image-specific)をご覧ください。\n\nまたは、Dockerfile で基本イメージを指定することもできます。 詳しくは、「[開発コンテナーの概要](/ja/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#dockerfile)」をご覧ください。\n\nリポジトリの開発コンテナー構成でイメージを指定しない場合は、既定の開発コンテナー イメージが使用されます。 既定のイメージには、一般的な言語と一般的に使用されるツールのランタイム バージョンが多数含まれています。 詳しくは、「[開発コンテナーの概要](/ja/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#using-the-default-dev-container-configuration)」をご覧ください。\n\nOrganization の所有者は、Organization 内で作成された codespace に使用できる開発コンテナー イメージを制限するポリシーを追加できます。\n\nポリシーで許可されていないイメージを指定する `devcontainer.json` を使用して codespace を作成しようとする場合、GitHub で次のメッセージが表示されます。\n\n> 開発コンテナー構成で指定されたイメージが許可されていないため、コードスペースを作成できません。 別のブランチを選択したり、コンテナーの構成を変更したり、組織のポリシー設定を調整したりする必要がある場合があります。\n\nCLI を使用すると、次のエラー メッセージが表示されます。\n\n> コードスペースの作成中にエラーが発生しました: HTTP 400: 基本イメージ 'IMAGE-REFERENCE' は、組織の管理者によって設定された組織ポリシーに基づいて許可されていません。\n\nコードスペースのイメージが Dockerfile で指定され、ポリシーと一致しない場合、コードスペースは、指定されたイメージではなく既定の回復コンテナーを使用して復旧モードで作成されます。 この効果を示すメッセージは、作成ログの最後に含まれます。 作成ログについて詳しくは、「[GitHub Codespaces のログ](/ja/codespaces/troubleshooting/github-codespaces-logs#creation-logs)」をご覧ください。\n\n> \\[!NOTE]\n>\n> * 開発コンテナーの基本イメージとホスト イメージを混同しないでください。 ホスト イメージは、開発コンテナーが実行される仮想マシンのビルドに使用されるイメージです。 詳しくは、「[安定版またはベータ版のホスト イメージの選択](/ja/codespaces/setting-your-user-preferences/choosing-the-stable-or-beta-host-image)」をご覧ください。\n> * 基本イメージ ポリシーは、コードスペースが作成されたとき、および完全なコンテナー再構築を実行するときに適用されます。 詳しくは、「[codespace ライフサイクルについて](/ja/codespaces/about-codespaces/understanding-the-codespace-lifecycle#rebuilding-a-codespace)」をご覧ください。\n> * 基本イメージ ポリシーは、既定のイメージ、またはコンテナーのリビルドを妨げる開発コンテナー構成にエラーが発生した場合に、codespace の復旧に使用されるイメージには適用されません。\n\n### オーガニゼーション単位でのポリシーとリポジトリ固有のポリシーの設定\n\nポリシーを作成するときに、ポリシーを Organaization 内のすべてのリポジトリに適用するか、指定されたリポジトリにのみ適用するかを選択します。 Organaization 全体のポリシーを設定する場合は、個々のリポジトリに対して設定するポリシーはすべて、Organaization レベルに設定した制限に収まるようにする必要があります。 ポリシーを追加すると、イメージの選択肢は、広くはならず、より一層制限されます。\n\nたとえば、基本イメージを指定した 10 個のイメージのいずれかに制限する Organization 全体のポリシーを作成できます。 その後、リポジトリ A のポリシーを設定して、Organization レベルで指定された 2 つのイメージのサブセットのみにイメージを制限できます。 リポジトリ A に追加のイメージを指定しても、これらのイメージは Organization レベルのポリシーで指定されていないため、効果はありません。 Organization 全体のポリシーを追加する場合は、Organization 内のどのリポジトリにも使用できるように、イメージの種類を最多の選択肢に設定する必要があります。 その後、リポジトリ固有のポリシーを追加することで、選択肢をさらに制限できます。\n\n> \\[!NOTE]\n> Codespaces ポリシーは、organization が支払う Codespaces にのみ適用されます。 誰かが自分の費用で組織内のリポジトリの codespace を作成した場合、その codespace はこれらのポリシーに制約されません。 詳しくは、「[組織内の codespace を誰が所有し、支払うかの選択](/ja/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization)」をご覧ください。\n\n## 許可されるイメージを定義するポリシーの追加\n\n1. GitHub の右上隅にあるプロフィール画像をクリックしてから、**\\[ Your organizations]** をクリックします。\n\n2. 組織をクリックして選択します。\n\n3. Organization 名の下で、**\\[ Settings]** をクリックします。 \\[設定] タブが表示されない場合は、 **\\[]** ドロップダウン メニューを選び、 **\\[設定]** をクリックします。\n\n ![組織のプロファイルのタブのスクリーンショット。 \\[設定\\] タブが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/discussions/org-settings-global-nav-update.png)\n\n4. サイドバーの \\[Code, planning, and automation]\\(コード、計画、自動化) の下で、\n \\*\\* \n Codespaces\n \\*\\*選択し、\\[**ポリシー**] をクリックします。\n\n5. \\[Codespaces ポリシー] ページで、 **\\[ポリシーの作成]** をクリックします。\n\n6. 新しいポリシーの名前を入力します。\n\n7. **\\[制約の追加]** をクリックし、 **\\[基本イメージ]** を選びます。\n\n8. 制約を編集するには、 をクリックします。\n\n9. \\[使用できる値] フィールドに、許可する Docker イメージのイメージ参照を入力します。\n\n ![\\[許可された値\\] フィールドにイメージ参照 \"mcr.microsoft.com/vscode/devcontainers/java\" が入力されたスクリーンショット。](/assets/images/help/codespaces/image-allowed-values.png)\n\n`*` ワイルドカードをイメージ参照の最後の文字として使用して、ワイルドカードの左側にある同じ参照で始まるすべてのイメージと一致させることができます。 たとえば、「 `mcr.microsoft.com/devcontainers/*` 」のように入力します。\n\n1. をクリックし、値を追加します。\n\n2. 必要に応じて、先ほどの 2 つの手順を繰り返して、さらにイメージ参照を追加します。\n\n 複数のイメージ参照を追加する場合、リポジトリの開発コンテナー構成で指定されたイメージ参照が、リポジトリに適用されるポリシー内のどの参照にも一致しない場合、そのリポジトリのコードスペースを作成することはできません。\n\n3. ダイアログ ボックスの外側をクリックして閉じます。\n\n4. 既定では、ポリシーはすべてのリポジトリに適用されるように設定されます。組織内の一部のリポジトリにのみ適用したい場合は、 **\\[すべてのリポジトリ]** をクリックしてから、ドロップダウン メニューの **\\[選択したリポジトリ]** をクリックします。\n\n ![\\[すべてのリポジトリ\\] と \\[選択したリポジトリ\\] のオプションが表示されている、リポジトリ選択ドロップダウンのスクリーンショット。](/assets/images/help/codespaces/selected-repositories.png)\n\n > \\[!NOTE]\n > \"Maximum codespaces per user\" 制約が既に含まれているポリシーに制約を追加する場合、選んだリポジトリにポリシーを適用することはできません。 これは、\"ユーザーあたりの最大 codespace 数\" 制約は、組織内のすべてのリポジトリに常に適用されるためです。\n\n **\\[選択したリポジトリ]** を選んだら、次のようにします。\n\n 1. をクリックします。\n\n ![\\[選択したリポジトリ\\] というラベルのボタンの左側にある設定アイコン (歯車シンボル) のスクリーンショット。](/assets/images/help/codespaces/policy-edit.png)\n\n 2. このポリシーを適用するリポジトリを選択します。\n\n 3. リポジトリ リストの下部にある **\\[リポジトリの選択]** をクリックします。\n\n \n\n5. ポリシーに別の制約を追加する場合は、 **\\[制約の追加]** をクリックして、別の制約を選びます。 その他の制約については、次を参照してください。\n * [コンピューターの種類へのアクセスを制限する](/ja/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)\n * [ユーザーが作成できる組織に請求される codespace の数の制限](/ja/codespaces/managing-codespaces-for-your-organization/restricting-the-number-of-organization-billed-codespaces-a-user-can-create)\n * [転送されるポートの可視性の制限](/ja/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)\n * [アイドル タイムアウトの期間を制限する](/ja/codespaces/managing-codespaces-for-your-organization/restricting-the-idle-timeout-period)\n * [codespace の保持期間を制限する](/ja/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)\n\n6. ポリシーへの制約の追加が終わったら、 **\\[保存]** をクリックします。\n\nポリシーは、Organization に請求できる新しい codespace を誰かが作成しようとしたときに適用されます。 基本イメージ制約は、アクティブまたは停止中の既存の codespace には影響しません。\n\n## ポリシーを編集する\n\n既存のポリシーを編集できます。 たとえば、ポリシーの制約を追加または削除できます。\n\n1. \\[Codespaces ポリシー] ページを表示します。 詳しくは、「[許可されるイメージを定義するポリシーを追加する](#adding-a-policy-to-define-the-allowed-images)」を参照してください。\n2. 編集するポリシーの名前をクリックします。\n3. 「ベースイメージ」制約の横にある鉛筆アイコン \\[] をクリックします。\n4. イメージ参照を追加または削除します。\n5. **\\[保存]** をクリックします。\n\n## ポリシーを削除する\n\n1. \\[Codespaces ポリシー] ページを表示します。 詳しくは、「[許可されるイメージを定義するポリシーを追加する](#adding-a-policy-to-define-the-allowed-images)」を参照してください。\n2. 削除するポリシーの右側にある をクリックします。\n\n "}