

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# カスタムクックブックのインストール
<a name="workingcookbook-installingcustom-enable"></a>

**重要**  
この AWS OpsWorks Stacks サービスは 2024 年 5 月 26 日にサポート終了となり、新規および既存のお客様の両方で無効になっています。できるだけ早くワークロードを他のソリューションに移行することを強くお勧めします。移行についてご質問がある場合は、[AWS re:Post](https://repost.aws/) または[AWS プレミアムサポート](https://aws.amazon.com/support)を通じて AWS サポート チームにお問い合わせください。

スタックがカスタムクックブックをインストールおよび使用するようにするには、すでに設定されていない場合はカスタムクックブックが有効になるようにスタックを設定する必要があります。リポジトリ URL と、パスワードなどの関連情報を指定する必要があります。

**重要**  
カスタムクックブックをサポートするようにスタックを設定すると、 OpsWorks スタックは起動時にすべての新しいインスタンスにクックブックを自動的にインストールします。ただし、カスタムクックブックの更新 OpsWorks スタックコマンドを実行して、既存のインスタンスに新規または更新されたクックブックをインストールするように スタックに明示的に指示する必要があります。 [****](workingstacks-commands.md)詳細については、「[カスタムクックブックの更新](workingcookbook-installingcustom-enable-update.md)」を参照してください。スタックの [**Use custom Chef cookbooks (カスタム Chef クックブックを使用する)**] を有効化する前に、実行するカスタムクックブックとコミュニティクックブックが、スタックで使用する Chef のバージョンをサポートしていることを確認してください。

**カスタムクックブックのスタックを設定するには**

1. スタックのページで、[**Stack Settings**] をクリックして [**Settings**] ページを表示し、[**Edit**] をクリックして設定を編集します。

1. [**Use custom Chef cookbooks**] を [**Yes**] に切り替えます。  
![\[スタックの設定ページの編集\]](http://docs.aws.amazon.com/ja_jp/opsworks/latest/userguide/images/stack_settings_edit.png)

1. カスタムクックブックを設定します。

設定が完了したら、[**Save**] をクリックして更新されたスタックを保存します。

## カスタムクックブックリポジトリの指定
<a name="workingcookbook-installingcustom-enable-repo"></a>

Linux スタックは、次のリポジトリタイプからカスタムクックブックをインストールできます。
+ HTTP や Amazon S3 のアーカイブ。

  これらはパブリックでもプライベートでもかまいませんが、通常プライベートアーカイブに推奨されるオプションは Amazon S3 です。
+ Git リポジトリと Subversion リポジトリは、ソース管理と複数のバージョンを設定する機能を提供します。

Windows スタックは、Amazon S3 アーカイブと Git リポジトリからカスタムクックブックをインストールできます。

すべてのリポジトリタイプに、以下の必須フィールドがあります。
+ [**Repository type**] (リポジトリタイプ) – リポジトリのタイプ
+ [**Repository URL**] (リポジトリ URL) – リポジトリの URL

OpsWorks スタックは、[GitHub](https://github.com/) や Bitbucket などのパブリックにホストされている Git リポジトリサイトと、プライベートにホストされている Git サーバーをサポートしています。 [https://bitbucket.org](https://bitbucket.org)Git リポジトリの場合、リポジトリがパブリックとプライベートのどちらであるかに応じて、次の URL 形式の 1 つを使用する必要があります。Git サブモジュールと同じ URL のガイドラインに従います。

パブリック Git リポジトリの場合は、HTTPS または Git の読み取り専用プロトコルを使用します。
+ Git 読み取り専用 – `git://github.com/amazonwebservices/opsworks-example-cookbooks.git`。
+ HTTPS –`https://github.com/amazonwebservices/opsworks-example-cookbooks.git`。

プライベート Git リポジトリの場合は、以下の例に示すように、SSH の読み取り/書き込み形式を使用する必要があります。
+ Github リポジトリ –`git@github.com:project/repository`。
+ Git サーバー上のリポジトリ – `user@server:project/repository`

残りの設定はリポジトリのタイプによって異なり、これらについて以下のセクションで説明します。

### HTTP アーカイブ
<a name="workingcookbook-installingcustom-enable-repo-http"></a>

**[Repository type]** (リポジトリタイプ) で **[Http Archive]** (Http アーカイブ) を選択すると、2 つの追加設定が表示されますが、アーカイブがパスワードで保護されている場合には設定を完了する必要があります。
+ **User name** - ユーザーネーム。
+ **[Password]** — パスワード

### Amazon S3 のアーカイブ
<a name="workingcookbook-installingcustom-enable-repo-s3"></a>

**リポジトリタイプ**に **S3 Archive** を選択すると、次の追加のオプション設定が表示されます。 OpsWorks スタックは、スタック API とコンソールのどちらを使用するかにかかわらず、Amazon EC2 OpsWorks ロール (ホストオペレーティングシステムマネージャー認証) を使用してリポジトリにアクセスできます。
+ **アクセスキー ID** – などの AWS アクセスキー IDAKIAIOSFODNN7EXAMPLE。
+ **シークレットアクセスキー** – など、対応する AWS シークレットアクセスキーwJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY。

### Git リポジトリ
<a name="workingcookbook-installingcustom-enable-repo-git"></a>

**[Source Control]** (ソースコントロール) で **[Git]** を選択すると、以下の追加オプション設定が表示されます。

[**Repository SSH key**]  
プライベート Git リポジトリにアクセスするには、デプロイ SSH キーを指定する必要があります。Git サブモジュールの場合、指定するキーには、それらのサブモジュールへのアクセス権が必要です。詳細については、「[Git リポジトリの SSH キーの使用](workingapps-deploykeys.md)」を参照してください。  
デプロイ SSH キーはパスワードを要求できません。 OpsWorks スタックにはパスワードを渡す方法がありません。

**[Branch/Revision]**  
リポジトリに複数のブランチがある場合、 OpsWorks スタックはデフォルトでマスターブランチをダウンロードします。特定のブランチを指定するには、ブランチ名、SHA1 ハッシュ、タグ名のいずれかを入力します。特定のコミットを指定するには、40 桁の 16 進数コミット ID を入力します。

### Subversion リポジトリ
<a name="workingcookbook-installingcustom-enable-repo-svn"></a>

**[Source Control]** (ソースコントロール) で **[Subversion]** を選択すると、以下の追加設定が表示されます。
+ [**User name**] (ユーザー名) - プライベートリポジトリのユーザー名。
+ [**Password**] (パスワード) - プライベートリポジトリのパスワード。
+ [**Revision**] (リビジョン) - (オプション) 複数のリビジョンがある場合のリビジョン名。

  ブランチまたはタグを指定するには、リポジトリ URL を変更する必要があります。例えば、**http://repository\$1domain/repos/myapp/branches/my-apps-branch** または **http://repository\$1domain\$1name/repos/calc/myapp/my-apps-tag** のように変更します。