Test Kitchen および Vagrant での Berkshelf の使用 AWS OpsWorks スタックでの Berkshelf の使用

Linux インスタンスでの外部クックブック Berkshelf の使用

重要

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

注記

Berkshelf は Chef 11.10 Linux スタックにのみ使用できます。

クックブックを実装する前に、Chef Community Cookbooks を確認してください。ここには、Chef コミュニティのメンバーによってさまざまな目的で作成されたクックブックがあります。これらのクックブックの多くは、変更せずに AWS OpsWorks スタックで使用できるため、すべてのコードを自分で実装するのではなく、一部のタスクで活用できる場合があります。

インスタンスで外部クックブックを使用するには、それをインストールし、依存関係を管理する方法が必要です。最適なアプローチは、依存関係マネージャをサポートする、Berkshelf という名前のクックブックを実装することです。Berkshelf は AWS OpsWorks スタックインスタンスを含む Amazon EC2 インスタンスで動作しますが、Test Kitchen や Vagrant でも動作するように設計されています。ただし、Vagrant の使用法は AWS OpsWorks スタックの使用法と少し異なるため、このトピックには両方のプラットフォームの例が含まれています。Berkshelf の使用方法の詳細については、「Berkshelf」を参照してください。

トピック

Test Kitchen および Vagrant での Berkshelf の使用
AWS OpsWorks スタックでの Berkshelf の使用

Test Kitchen および Vagrant での Berkshelf の使用

この例では、Berkshelf を使用して getting-started コミュニティクックブックをインストールし、そのレシピを実行する方法を示します。このレシピは、短いテキストファイルをインスタンスのホームディレクトリにインストールします。

Berkshelf をインストールし、クックブックを初期化するには

ワークステーションで、Berkshelf gem を次のようにインストールします。
```
gem install berkshelf
```
ワークステーションによっては、このコマンドで sudo が必要になる場合があります。また、RVM などの Ruby 環境マネージャを使用することもできます。Berkshelf が正常にインストールされたことを確認するには、berks --version を実行します。
このトピックのクックブックは、external_cookbook という名前です。以前のトピックで採用した手動のアプローチの代わりに、Berkshelf を使用して、初期化されたクックブックを作成できます。そのためには、opsworks_cookbooks ディレクトリに移動して、次のコマンドを実行します。
```
berks cookbook external_cookbook
```
このコマンドによって、external_cookbook ディレクトリといくつかの標準的な Chef および Test Kitchen サブディレクトリ (recipes、test など) が作成されます。さらに、次のような多数の標準ファイルのデフォルトバージョンも作成されます。
- metadata.rb
- Vagrant、Test Kitchen、および Berkshelf の設定ファイル
- default.rb ディレクトリにある空の recipes レシピ
注記
kitchen init を実行する必要はありません。それらのタスクは berks cookbook コマンドによって処理されます。
kitchen converge を実行します。新しく作成したクックブックは、この時点では興味深いことを何もしませんが、集中を行います。

注記

また、berks init を使用して、Berkshelf を使用するように既存のクックブックを初期化できます。

Berkshelf を使用してクックブックの外部依存関係を管理するには、クックブックのルートディレクトリに Berksfile が含まれている必要があります。これは、Berkshelf がどのように依存関係を管理するかを指定する設定ファイルです。berks cookbook クックブックを作成するために external_cookbook を使用した場合、以下の内容の Berksfile が作成されます。



source "https://supermarket.chef.io"
metadata

このファイルには、以下の宣言があります。

source – クックブックソースの URL。

Berksfile は、任意の数の source 宣言を持つことができます。各宣言は、依存クックブックのデフォルトのソースを指定します。クックブックのソースを明示的に指定しない場合、Berkshelf はデフォルトのリポジトリで同じ名前のクックブックを探します。デフォルト Berksfile には、コミュニティクックブックリポジトリを指定する単一の source 属性が含まれています。そのリポジトリには getting-started クックブックが含まれているので、行を変更する必要はありません。
metadata – クックブックの metadata.rb ファイルで宣言されているクックブックの依存関係を取り込むように Berkshelf に指示します。

また、後で説明するように、cookbook 属性を取り込むことによって、Berksfile で依存クックブックを宣言できます。

クックブックの依存関係を宣言するには、次の 2 つの方法があります。

cookbook 宣言を Berksfile に含めます。

これは AWS OpsWorks スタックで使用されるアプローチです。たとえば、この例で使用されている getting-started クックブックを指定するには、Berksfile に cookbook "getting-started" を含めます。そうすると、Berkshelf はデフォルトリポジトリでその名前のクックブックを探します。また、cookbook を使用して、明示的にクックブックソースと特定のバージョンを指定することもできます。詳細については「Berkshelf」を参照してください。
metadata 宣言を Berksfile に含め、依存関係を metadata.rb で宣言します。

この宣言は、metadata.rb で宣言されているクックブックの依存関係を取り込むように Berkshelf に指示します。たとえば、getting-started の依存関係を宣言するには、クックブックの depends 'getting-started' ファイルに metadata.rb 宣言を追加します。

この例では、 AWS OpsWorks スタックとの一貫性を保つために、最初のアプローチを使用します。

getting-started クックブックをインストールするには

デフォルト Berksfile を編集して、metadata 宣言を cookbook の getting-started 宣言に置き換えます。内容は次のようになります。
```
source "https://supermarket.chef.io"

cookbook 'getting-started'
```
berks install を実行すると、コミュニティクックブックリポジトリからワークステーションの Berkshelf ディレクトリ (通常は ~/.berkshelf) に getting-started クックブックがダウンロードされます。このディレクトリは、多くの場合、単に Berkshelf と呼ばれます。Berkshelf の cookbooks ディレクトリを見ると、クックブックのディレクトリ (getting-started-0.4.0getting-started- のような名前のディレクトリ) が表示されるはずです。
external_cookbook::default 実行リスト内の .kitchen.yml を getting-started::default に置き換えます。この例は external_cookbook のどのレシピも実行しません。基本的には、単に getting-started クックブックを使用するための手段です。.kitchen.yml ファイルは次のようになっているはずです。
```
---
driver:
  name: vagrant

provisioner:
  name: chef_solo

platforms:
  - name: ubuntu-12.04

suites:
  - name: default
    run_list:
      - recipe[getting-started::default]
    attributes:
```
kitchen converge を実行してから kitchen login を使用してインスタンスにログインします。ログインディレクトリには、次のような内容の chef-getting-started.txt という名前のファイルが含まれているはずです。
```
Welcome to Chef!

This is Chef version 11.12.8.
Running on ubuntu.
Version 12.04.
```
Test Kitchen によって、インスタンスの /tmp/kitchen/cookbooks ディレクトリ内のクックブックがインストールされます。このディレクトリの内容を一覧表示すると、external_cookbook と getting-started という 2 つのクックブックが表示されます。
kitchen destroy を実行して、インスタンスをシャットダウンします。次の例では、 AWS OpsWorks スタックインスタンスを使用します。

AWS OpsWorks スタックでの Berkshelf の使用

AWS OpsWorks スタックは、Chef 11.10 スタックの Berkshelf をオプションでサポートします。スタックで Berkshelf を使用するには、以下の操作を実行する必要があります。

スタックの Berkshelf を有効にします。

AWS OpsWorks その後、スタックはスタックのインスタンスに Berkshelf をインストールする詳細を処理します。
クックブックリポジトリのルートディレクトリに Berksfile を追加します。

Berksfile には、すべての依存クックブックの source および cookbook 宣言が含まれている必要があります。

AWS OpsWorks スタックがインスタンスにカスタムクックブックリポジトリをインストールすると、Berkshelf を使用して、リポジトリの Berksfile で宣言されている依存クックブックをインストールします。詳細については、「Berkshelf の使用」を参照してください。

この例では、Berkshelf を使用して AWS OpsWorks スタックインスタンスに入門コミュニティクックブックをインストールする方法を示します。また、指定したディレクトリ内にファイルを作成する、createfile カスタムクックブックのバージョンもインストールします。createfile の動作の詳細については、「クックブックからのファイルのインストール」を参照してください。

注記

AWS OpsWorks スタックスタックにカスタムクックブックを初めてインストールする場合は、まずこのLinux インスタンスでのレシピの実行例を実行する必要があります。

以下にまとめたように、スタックの作成から始めます。詳細については、「新しいスタックを作成する」を参照してください。

Stack を作成する

AWS OpsWorks スタックコンソールを開いて [Add Stack] をクリックします。
次の設定を指定し、その他の設定はデフォルト値を受け入れて、[Add Stack] をクリックします。
- 名前 – BerksTest
- Default SSH key (デフォルト SSH キー) - Amazon EC2 キーペア
Amazon EC2 キーペアの作成が必要な場合は、「Amazon EC2 Key Pairs」(Amazon EC2 キーペア) を参照してください。キーペアがインスタンスと同じ AWS リージョンに属している必要があることに注意してください。この例では、デフォルトに米国西部(オレゴン) リージョンを使用します。
[Add a layer] をクリックし、次の設定を使用してスタックにカスタムレイヤーを追加します。
- 名前 – BerksTest
- Short name (短縮名) – berkstest
この例では、実際には任意のレイヤータイプを使用できます。しかし、この例では他のレイヤーによってインストールされるパッケージは必要ないので、カスタムレイヤーが最もシンプルなアプローチです。
デフォルト設定で 24/7 インスタンスを BerksTest レイヤーに追加しますが、まだ起動しないでください。

AWS OpsWorks スタックでは、クックブックは標準のディレクトリ構造を持つリモートリポジトリにある必要があります。次に、 AWS OpsWorks スタックにダウンロード情報を提供します。これにより、起動時にスタックの各インスタンスにリポジトリが自動的にダウンロードされます。わかりやすくするために、この例のリポジトリはパブリック Amazon S3 アーカイブですが、 AWS OpsWorks スタックは HTTP アーカイブ、Git リポジトリ、および Subversion リポジトリもサポートしています。詳細については、「クックブックリポジトリ」を参照してください。

Amazon S3 バケットに配信されるコンテンツには、カスタマーコンテンツが含まれている場合があります。機密データの削除の詳細については、「S3 バケットを空にする方法」または「S3 バケットを削除する方法」を参照してください。

クックブックリポジトリを作成するには

opsworks_cookbooks ディレクトリに berkstest_cookbooks という名前のディレクトリを作成します。このディレクトリは、リポジトリにアップロードするため、都合のよい任意の場所に作成することもできます。
以下の内容で、Berksfile という名前のファイルを berkstest_cookbooks に追加します。
```
source "https://supermarket.chef.io"

cookbook 'getting-started'
```
このファイルは、getting-started クックブックの依存関係を宣言し、それをコミュニティクックブックサイトからダウンロードするように Berkshelf に指示します。
以下を含む createfile に berkstest_cookbooks ディレクトリを追加します。
- 以下の内容の metadata.rb ファイル。
```
name "createfile"
version "0.1.0"
```
- 以下のコンテンツを持つ files/default ファイルが含まれている example_data.json ディレクトリ。
```
{
  "my_name" : "myname",
  "your_name" : "yourname",
  "a_number" : 42,
  "a_boolean" : true
}
```
  ファイルの名前および内容は任意です。レシピは単に、指定された場所にファイルをコピーします。
- 以下のレシピコードを持つ recipes ファイルが含まれている default.rb ディレクトリ。
```
directory "/srv/www/shared" do
  mode 0755
  owner 'root'
  group 'root'
  recursive true
  action :create
end

cookbook_file "/srv/www/shared/example_data.json" do
  source "example_data.json"
  mode 0644
  action :create_if_missing
end
```
  このレシピは、/srv/www/shared を作成し、クックブックの example_data.json ディレクトリからそのディレクトリに files をコピーします。
berkstest_cookbooks の .zip アーカイブを作成して [アーカイブを Amazon S3 バケットにアップロードし、アーカイブを公開して、アーカイブの URL を記録しておきます。

これで、クックブックをインストールし、レシピを実行できるようになりました。

クックブックをインストールし、レシピを実行するには

カスタムクックブックを有効にするようにスタックを編集し、以下の設定を指定します。
- Repository type (リポジトリタイプ) – Http Archive (Http アーカイブ)
- Repository URL (リポジトリの URL) – 前の手順で記録したクックブックのアーカイブの URL
- Manage Berkshelf (Berkshelf の管理) – Yes (はい)
最初の 2 つの設定は、クックブックリポジトリをインスタンスにダウンロードするために必要な情報を AWS OpsWorks スタックに提供します。最後の設定は、Berkshelf サポートを有効にします。これによって、getting-started クックブックがインスタンスにダウンロードされます。その他の設定ではデフォルト値を受け入れ、[Save] をクリックしてスタック設定を更新します。
BerksTest レイヤーを編集して、レイヤーの Setup ライフサイクルイベントに次のレシピを追加します。
- getting-started::default
- createfile::default
インスタンスを起動します。Setup イベントは、インスタンスの起動が完了した後に発生します。 AWS OpsWorks スタックはクックブックリポジトリをインストールし、Berkshelf を使用して入門クックブックをダウンロードし、 getting-started::defaultやなどのレイヤーのセットアップとデプロイレシピを実行しますcreatefile::default。
インスタンスがオンラインになったら、SSH を使用してログインします。次のように表示されます。
- /srv/www/shared には example_data.json が含まれている必要があります。
- /root には chef-getting-started.txt が含まれている必要があります。
  
  AWS OpsWorks スタックはレシピをルートとして実行するため、入門時にホーム/rootディレクトリではなくディレクトリにファイルがインストールされます。

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

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

ドキュメントの表記規則

Windows AWS OpsWorks スタックでのスタック固有の検索インデックスの使用

SDK for Ruby を使用する