Chef 12 での依存関係のローカルパッケージ化ローカルで 1 つのクックブックの依存関係をパッケージ化するローカルで複数のクックブックの依存関係をパッケージ化するその他のリソース

ローカルでのクックブックの依存関係のパッケージ化

重要

AWS OpsWorks Stacks は新規顧客を受け付けなくなりました。既存のお客様は、2024 年 5 月 26 日までは OpsWorks コンソール、 API、 CLI、および CloudFormation リソースを通常どおり使用できますが、その時点でこれらのリソースは廃止されます。この移行に備えて、できるだけ早くスタックを AWS Systems Manager に移行することをおすすめします。詳細については、AWS OpsWorks Stacks サポート終了に関する FAQ および AWS Systems Manager アプリケーションマネージャへの AWS OpsWorks Stacks アプリケーションの移行を参照してください。

Berkshelf を使用してローカルでクックブックの依存関係をパッケージ化し、Amazon S3 にパッケージをアップロードし、スタックを変更して、Amazon S3 パッケージをクックブックのソースとして使用できます。Amazon S3 バケットに配信されるコンテンツには、カスタマーコンテンツが含まれている場合があります。機密データの削除の詳細については、「S3 バケットを空にする方法」または「S3 バケットを削除する方法」を参照してください。

以下のチュートリアルでは、クックブックとその依存関係を .zip ファイルに事前にパッケージ化した後、AWS OpsWorks スタックでその .zip ファイルを Linux インスタンスのクックブックのソースとして使用する方法について説明します。最初のチュートリアルでは、1 つのクックブックをパッケージ化する方法を説明します。2 番目のチュートリアルでは、複数のクックブックをパッケージ化する方法について説明します。

始める前に、Chef Development Kit (Chef DK とも呼ばれる) をインストールします。これは Chef コミュニティによって開発されたツールのセットです。ChefDK は chef コマンドラインツールを使用するために必要です。

Chef 12 での依存関係のローカルパッケージ化

Chef 12 Linux では、Berkshelf がスタックインスタンスにデフォルトでインストールされなくなりました。ローカルの開発用コンピュータに Berkshelf をインストールし、これを使用してクックブックの依存関係をローカルにパッケージ化することをお勧めします。依存関係を含めたパッケージを Amazon S3 にアップロードします。最後に、クックブックソースとしてアップロードされたパッケージを使用するように Chef Linux 12 のスタックを変更します。Chef 12 でクックブックをパッケージ化する場合は、以下の相違点に注意してください。

ローカルコンピュータで、chef コマンドラインツールを使用してクックブックを作成します。
```
chef generate cookbook "server-app"
```
このコマンドによってクックブック、Berksfile、metadata.rb ファイル、およびレシピディレクトリが作成され、クックブックと同じ名前のフォルダに配置されます。次の例は、作成される項目の構造を示しています。
```
server-app <-- the cookbook you've just created
    └── Berksfile
    ├── metadata.rb
    └── recipes
```
テキストエディタで Berksfile を編集し、server-app クックブックの依存先のクックブックを指定します。この例では server-app が Chef Supermarket の java クックブックに依存するように指定します。ここでは、バージョン 1.50.0 または以降の新しい マイナー バージョンを指定しますが、任意の発行済みバージョンを単一引用符で囲んで入力できます。変更内容を保存し、ファイルを閉じます。
```
source 'https://supermarket.chef.io'
cookbook 'java', '~> 1.50.0'
```
metadata.rb ファイルを編集して、依存関係を追加します。変更内容を保存し、ファイルを閉じます。
```
depends 'java' , '~> 1.50.0'
```
Chef で作成された server-app クックブックのディレクトリに変更し、package コマンドを実行して、クックブックの tar ファイルを作成します。複数のクックブックをパッケージ化する場合は、このコマンドを、すべてのクックブックが保存されているルートディレクトリで実行します。1 つのクックブックをパッケージ化するには、このコマンドをクックブックディレクトリレベルで実行します。次の例では、このコマンドを server-app ディレクトリで実行します。
```
berks package cookbooks.tar.gz
```
出力は以下のようになります。tar.gz ファイルがローカルディレクトリに作成されます。
```
Cookbook(s) packaged to /Users/username/tmp/berks/cookbooks.tar.gz
```
AWS CLI で、先ほど作成したパッケージを Amazon S3 にアップロードします。S3; にアップロードした後でクックブックパッケージの新しい URL を書き留めます。この URL は、スタックの設定で必要になります。
```
aws s3 cp cookbooks.tar.gz s3://bucket-name/
```
出力は以下のようになります。
```
upload: ./cookbooks.tar.gz to s3://bucket-name/cookbooks.tar.gz
```
AWS OpsWorks スタックで、アップロードしたパッケージをクックブックのソースとして使用するように、スタックを変更します。
1. [Use custom Chef cookbooks] を [Yes] に設定します。
2. [Repository type] を [S3 Archive] に設定します。
3. [Repository URL] に、ステップ 5 でアップロードしたクックブックパッケージの URL を貼り付けます。
スタックの変更を保存します。

ローカルで 1 つのクックブックの依存関係をパッケージ化する

ローカルコンピュータで、以下の chef コマンドラインツールを使用してクックブックを作成します。
```
chef generate cookbook "server-app"
```
このコマンドによってクックブックと Berksfile が作成され、クックブックと同じ名前のフォルダに配置されます。
Chef によって作成されたクックブックのディレクトリに変更し、以下のコマンドを実行して、その内容をすべてパッケージ化します。
```
berks package cookbooks.tar.gz
```
出力は次のようになります。
```
Cookbook(s) packaged to /Users/username/tmp/berks/cookbooks.tar.gz
```
AWS CLI で、先ほど作成したパッケージを Amazon S3 にアップロードします。
```
aws s3 cp cookbooks.tar.gz s3://bucket-name/
```
出力は次のようになります。
```
upload: ./cookbooks.tar.gz to s3://bucket-name/cookbooks.tar.gz
```
AWS OpsWorks スタックで、アップロードしたパッケージをクックブックのソースとして使用するように、スタックを変更します。

ローカルで複数のクックブックの依存関係をパッケージ化する

この例では、2 つのクックブックを作成し、それらの依存関係をパッケージ化します。

ローカルコンピュータで、以下の chef コマンドを実行して、2 つのクックブックを生成します。
```
chef generate cookbook "server-app"
chef generate cookbook "server-utils"
```
この例では、server-app クックブックによって Java が設定されるため、Java への依存関係を追加する必要があります。

コミュニティ Java クックブックへの依存関係を追加するように、server-app/metadata.rb を以下のように編集します。


maintainer "The Authors"
maintainer_email "you@example.com"
license "all_rights"
description "Installs/Configures server-app"
long_description "Installs/Configures server-app"
version "0.1.0"
depends "java"

Berkshelf にパッケージ化対象を指定するように、クックブックのルートディレクトリ内の Berksfile ファイルを以下のように編集します。
```
source "https://supermarket.chef.io"
cookbook "server-app", path: "./server-app"
cookbook "server-utils", path: "./server-utils"
```
ファイル構造は以下のようになります。
```
 .. 
    └── Berksfile
    ├── server-app
    └── server-utils
```
最後に、zip パッケージを作成して Amazon S3 にアップロードし、新しいクックブックのソースを使用するように AWS OpsWorks スタックスタックを変更します。そのためには、「ローカルで 1 つのクックブックの依存関係をパッケージ化する」の手順 2 ～ 4 に従います。

その他のリソース

クックブックの依存関係のパッケージ化の詳細については、以下を参照してください。

AWS DevOps Blog の「How to Package Cookbook Dependencies Locally with Berkshelf」
フォーラムの「Linux Chef 12 with BerkshelfAWS OpsWorks」
フォーラムの「Berkshelf in Chef 12AWS OpsWorks」
このガイドの「カスタムクックブックのインストール」
このガイドの「クックブックリポジトリ」

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

アプリケーションとクックブックの管理とデプロイ

スタック