パートナーのソリューションの統合

手順

1. rhosp-director-images および rhosp-director-images-ipa パッケージをインストールして、これらのイメージを取得します。

   $ sudo yum install rhosp-director-images rhosp-director-images-ipa

   Copy to Clipboard Toggle word wrap

2. stack ユーザーのホーム (/home/stack/images) の images ディレクトリーにアーカイブを展開します。

   $ cd ~/images
   $ for i in /usr/share/rhosp-director-images/overcloud-full-latest-13.0.tar /usr/share/rhosp-director-images/ironic-python-agent-latest-13.0.tar; do tar -xvf $i; done

   Copy to Clipboard Toggle word wrap

手順

1. root ユーザーとしてログインして、ramdisk の一時ディレクトリーを作成します。

   # mkdir ~/ipa-tmp
   # cd ~/ipa-tmp

   Copy to Clipboard Toggle word wrap

2. skipcpio と cpio コマンドを使用して、一時ディレクトリーに ramdisk を展開します。

   # /usr/lib/dracut/skipcpio ~/images/ironic-python-agent.initramfs | zcat | cpio -ivd | pax -r

   Copy to Clipboard Toggle word wrap

3. 展開したコンテンツに RPM パッケージをインストールします。

   # rpm2cpio ~/RPMs/python-proliantutils-2.1.7-1.el7ost.noarch.rpm | pax -r

   Copy to Clipboard Toggle word wrap

4. 新しい ramdisk を再作成します。

   # find . 2>/dev/null | cpio --quiet -c -o | gzip -8  > /home/stack/images/ironic-python-agent.initramfs
   # chown stack: /home/stack/images/ironic-python-agent.initramfs

   Copy to Clipboard Toggle word wrap

5. ramdisk に新しいパッケージが存在することを確認します。

   # lsinitrd /home/stack/images/ironic-python-agent.initramfs | grep proliant

   Copy to Clipboard Toggle word wrap

手順

1. overcloud-full.qcow2 イメージを使用する仮想マシンインスタンスを作成するには、guestmount コマンドを使用します。

   $ mkdir ~/overcloud-full
   $ guestmount -a overcloud-full.qcow2 -i --ro ~/overcloud-full

   Copy to Clipboard Toggle word wrap

   QCOW2 イメージの内容は、~/overcloud-full で確認できます。

2. または、virt-manager を使用して、以下の起動オプションで仮想マシンを作成できます。

   • カーネルのパス: /overcloud-full.vmlinuz
   • initrd のパス: /overcloud-full.initrd
   • カーネルの引数: root=/dev/sda

手順

1. イメージを一時的に登録して、カスタマイズに適切な Red Hat のリポジトリーを有効にします。

   $ virt-customize --selinux-relabel -a overcloud-full.qcow2 --run-command 'subscription-manager register --username=[username] --password=[password]'
   [  0.0] Examining the guest ...
   [ 10.0] Setting a random seed
   [ 10.0] Running: subscription-manager register --username=[username] --password=[password]
   [ 24.0] Finishing off

   Copy to Clipboard Toggle word wrap

2. [username] および [password] を、ご自分の Red Hat カスタマーアカウント情報に置き換えてください。これで、イメージに対して以下のコマンドが実行されます。

   subscription-manager register --username=[username] --password=[password]

   Copy to Clipboard Toggle word wrap

手順

1. アカウントのサブスクリプションからプール ID の一覧を検索します。

   $ sudo subscription-manager list

   Copy to Clipboard Toggle word wrap

2. サブスクリプションプール ID を選択して、その ID をイメージにアタッチします。

   $ virt-customize --selinux-relabel -a overcloud-full.qcow2 --run-command 'subscription-manager attach --pool [subscription-pool]'
   [  0.0] Examining the guest ...
   [ 12.0] Setting a random seed
   [ 12.0] Running: subscription-manager attach --pool [subscription-pool]
   [ 52.0] Finishing off

   Copy to Clipboard Toggle word wrap

3. [subscription-pool] は選択したサブスクリプションプール ID に置き換えてください。

   subscription-manager attach --pool [subscription-pool]

   Copy to Clipboard Toggle word wrap

   これにより、リポジトリーを有効にできるように、イメージにプールが追加されます。

4. Red Hat リポジトリーを有効にします。

   $ subscription-manager repos --enable=[repo-id]

   Copy to Clipboard Toggle word wrap

手順

1. opendaylight.repo ファイルの内容を一覧表示します。

   $ cat opendaylight.repo
   
   [opendaylight]
   name=OpenDaylight Repository
   baseurl=https://nexus.opendaylight.org/content/repositories/opendaylight-yum-epel-6-x86_64/
   gpgcheck=0

   Copy to Clipboard Toggle word wrap

2. リポジトリーファイルをイメージにコピーします。

   $ virt-customize --selinux-relabel -a overcloud-full.qcow2 --upload opendaylight.repo:/etc/yum.repos.d/
   [  0.0] Examining the guest ...
   [ 12.0] Setting a random seed
   [ 12.0] Copying: opendaylight.repo to /etc/yum.repos.d/
   [ 13.0] Finishing off

   Copy to Clipboard Toggle word wrap

   --upload オプションは、リポジトリーファイルをオーバークラウドイメージの /etc/yum.repos.d/ にコピーします。

手順

1. コマンドラインから director にアクセスできるように、stackrc ファイルを読み込みます。

   $ source stackrc

   Copy to Clipboard Toggle word wrap

2. オーバークラウドのデプロイに使用するデフォルトの director イメージをアップロードします。

   $ openstack overcloud image upload --image-path /home/stack/images/

   Copy to Clipboard Toggle word wrap

   このコマンドにより、以下のイメージが director にアップロードされます。

   • bm-deploy-kernel
   • bm-deploy-ramdisk
   • overcloud-full
   • overcloud-full-initrd

   • overcloud-full-vmlinuz

     スクリプトにより、director の PXE サーバー上にイントロスペクションイメージもインストールされます。

3. CLI でイメージ一覧を表示します。

   $ openstack image list
   +--------------------------------------+------------------------+
   | ID                                   | Name                   |
   +--------------------------------------+------------------------+
   | 765a46af-4417-4592-91e5-a300ead3faf6 | bm-deploy-ramdisk      |
   | 09b40e3d-0382-4925-a356-3a4b4f36b514 | bm-deploy-kernel       |
   | ef793cd0-e65c-456a-a675-63cd57610bd5 | overcloud-full         |
   | 9a51a6cb-4670-40de-b64b-b70f4dd44152 | overcloud-full-initrd  |
   | 4f7e33f4-d617-47c1-b36f-cbe90f132e5d | overcloud-full-vmlinuz |
   +--------------------------------------+------------------------+

   Copy to Clipboard Toggle word wrap

   この一覧には、イントロスペクションの PXE イメージ (agent.*) は表示されません。director は、これらのファイルを /httpboot にコピーします。

   [stack@host1 ~]$ ls /httpboot -l
   total 151636
   -rw-r--r--. 1 ironic ironic       269 Sep 19 02:43 boot.ipxe
   -rw-r--r--. 1 root   root         252 Sep 10 15:35 inspector.ipxe
   -rwxr-xr-x. 1 root   root     5027584 Sep 10 16:32 agent.kernel
   -rw-r--r--. 1 root   root   150230861 Sep 10 16:32 agent.ramdisk
   drwxr-xr-x. 2 ironic ironic      4096 Sep 19 02:45 pxelinux.cfg

   Copy to Clipboard Toggle word wrap

手順

1. ブラウザーで、https://github.com/openstack に移動します。
2. フィルターセクションで Puppet を検索します。すべての Puppet モジュールには、puppet- の接頭辞が使用されます。

3. 必要な Puppet モジュールのクローンを作成します。たとえば、公式の OpenStack Block Storage (cinder) モジュールの場合は、次のようになります。

   $ git clone https://github.com/openstack/puppet-cinder.git

   Copy to Clipboard Toggle word wrap

1. OS::TripleO::NodeUserData は、コレクション内の他のテンプレートで使用する director ベースの Heat リソースで、全ノードに対して初回起動の設定を適用します。このリソースは、cloud-init で使用するデータを渡します。デフォルトの NodeUserData は、空の値 (firstboot/userdata_default.yaml) を指定する Heat テンプレートを参照します。この例では、firstboot.yaml の環境ファイルは、このデフォルトを独自の nameserver.yaml ファイルへの参照に置き換えます。
2. nameserver_config は、初回起動で実行する Bash スクリプトを定義します。OS::Heat::SoftwareConfig リソースは、適用する設定としてこれを定義します。
3. userdata は、OS::Heat::MultipartMime リソースを使用して、nameserver_config から複数のパートからなる MIME メッセージに設定を変換します。
4. outputs では、output パラメーターの OS::stack_id が提供され、userdata から MIME メッセージを呼び出している Heat テンプレート/リソースに渡します。

1. OS::TripleO::ControllerExtraConfigPre は、Heat テンプレートコレクション内の設定テンプレートで使用する director ベースの Heat リソースです。このリソースは、各コントローラーノードに設定を渡します。デフォルトの ControllerExtraConfigPre は、空の値 (puppet/extraconfig/pre_deploy/default.yaml) を指定する Heat テンプレートを参照します。この例では、pre_config.yaml 環境ファイルは、このデフォルトを独自の nameserver.yaml ファイルへの参照に置き換えます。
2. 環境ファイルは、この環境の parameter_default の値として nameserver_ip を渡します。これは、ネームサーバーの IP アドレスを保存するパラメーターです。nameserver.yaml の Heat テンプレートは、parameters セクションで定義したように、このパラメーターを受け入れます。
3. このテンプレートは、 OS::Heat::SoftwareConfig を使用して設定リソースとして CustomExtraConfigPre を定義します。group: script プロパティーに注意してください。group は、使用するソフトウェア設定ツールを定義します。このソフトウェア設定ツールは Heat のフックセットで入手できます。この場合は、script フックは、SoftwareConfig リソースで config プロパティーとして定義される実行可能なスクリプトを実行します。

4. このスクリプト自体は、/etc/resolve.conf にネームサーバーの IP アドレスを追加します。str_replace の属性に注意してください。これにより、template セクションの変数を params セクションのパラメーターに置き換えることが可能となります。この場合は、NAMESERVER_IP をネームサーバーの IP アドレスに設定します。スクリプト内の同じ変数はこの IP アドレスに置き換えられます。その結果、スクリプトは以下のようになります。

   #!/bin/sh
   echo "nameserver 192.168.1.1" >> /etc/resolve.conf

   Copy to Clipboard Toggle word wrap

1. OS::TripleO::NodeExtraConfig は、Heat テンプレートコレクション内の設定テンプレートで使用する director ベースの Heat リソースです。このリソースは、各ノードに設定を渡します。デフォルトの NodeExtraConfig は、空の値 (puppet/extraconfig/pre_deploy/default.yaml) を指定する Heat テンプレートを参照します。この例では、pre_config.yaml 環境ファイルは、このデフォルトを独自の nameserver.yaml ファイルへの参照に置き換えます。
2. 環境ファイルは、この環境の parameter_default の値として nameserver_ip を渡します。これは、ネームサーバーの IP アドレスを保存するパラメーターです。nameserver.yaml の Heat テンプレートは、parameters セクションで定義したように、このパラメーターを受け入れます。
3. このテンプレートは、 OS::Heat::SoftwareConfig を使用して設定リソースとして CustomExtraConfigPre を定義します。group: script プロパティーに注意してください。group は、使用するソフトウェア設定ツールを定義します。このソフトウェア設定ツールは Heat のフックセットで入手できます。この場合は、script フックは、SoftwareConfig リソースで config プロパティーとして定義される実行可能なスクリプトを実行します。

4. このスクリプト自体は、/etc/resolve.conf にネームサーバーの IP アドレスを追加します。str_replace の属性に注意してください。これにより、template セクションの変数を params セクションのパラメーターに置き換えることが可能となります。この場合は、NAMESERVER_IP をネームサーバーの IP アドレスに設定します。スクリプト内の同じ変数はこの IP アドレスに置き換えられます。その結果、スクリプトは以下のようになります。

   #!/bin/sh
   echo "nameserver 192.168.1.1" >> /etc/resolve.conf

   Copy to Clipboard Toggle word wrap

1. OS::TripleO::NodeExtraConfigPost は、コレクション内の設定後のテンプレートで使用する director ベースの Heat リソースです。このリソースは、*-post.yaml テンプレートを使用して各ノード種別に設定を渡します。デフォルトの NodeExtraConfigPost は、空の値 (extraconfig/post_deploy/default.yaml) を指定する Heat テンプレートを参照します。この例では、post_config.yaml の環境ファイルは、このデフォルトを独自の nameserver.yaml ファイルへの参照に置き換えます。
2. 環境ファイルは、この環境の parameter_default の値として nameserver_ip を渡します。これは、ネームサーバーの IP アドレスを保存するパラメーターです。nameserver.yaml の Heat テンプレートは、parameters セクションで定義したように、このパラメーターを受け入れます。
3. このテンプレートは、OS::Heat::SoftwareConfig を使用して設定リソースとして CustomExtraConfig を定義します。group: script プロパティーに注意してください。group は、使用するソフトウェア設定ツールを定義します。このソフトウェア設定ツールは Heat のフックセットで入手できます。この場合は、script フックは、SoftwareConfig リソースで config プロパティーとして定義される実行可能なスクリプトを実行します。

4. このスクリプト自体は、/etc/resolve.conf にネームサーバーの IP アドレスを追加します。str_replace の属性に注意してください。これにより、template セクションの変数を params セクションのパラメーターに置き換えることが可能となります。この場合は、NAMESERVER_IP をネームサーバーの IP アドレスに設定します。スクリプト内の同じ変数はこの IP アドレスに置き換えられます。その結果、スクリプトは以下のようになります。

   #!/bin/sh
   echo "nameserver 192.168.1.1" >> /etc/resolve.conf

   Copy to Clipboard Toggle word wrap

1. puppet フックを実行するために group: puppet を設定します。
2. config 属性は get_file 属性を使用して、追加の設定が含まれる Puppet マニフェストを参照します。

3. options 属性には、Puppet 設定固有のオプションが含まれます。

   • enable_hiera オプションは、Puppet 設定で Hiera データを使用できるようにします。
   • enable_facter オプションは、facter コマンドからシステムファクトを使用する Puppet 設定を有効にします。

手順

1. OS::TripleO::Services 名前空間内の登録済み Heat リソースとして新規サービスを 環境ファイル (env-motd.yaml) に追加します。この例では、motd サービスのリソース名は OS::TripleO::Services::Motd です。

   resource_registry:
     OS::TripleO::Services::Motd: /home/stack/templates/motd.yaml
   
   parameter_defaults:
     MotdMessage: |
       You have successfully accessed my Red Hat OpenStack Platform environment!

   Copy to Clipboard Toggle word wrap

   このカスタム環境ファイルには、デフォルトの MotdMessage を上書きする新しいメッセージも含まれています。

   デプロイメントに motd サービスが追加されました。ただし、この新規サービスを必要とする各ロールは、カスタムの roles_data.yaml ファイルにある ServicesDefault リストを更新する必要があります。

2. デフォルトの roles_data.yaml ファイルのコピーを作成します。

   $ cp /usr/share/openstack-tripleo-heat-templates/roles_data.yaml ~/custom_roles_data.yaml

   Copy to Clipboard Toggle word wrap

3. このファイルを編集して、Controller ロールにスクロールし、ServicesDefault リストにサービスを追加します。

   - name: Controller
     CountDefault: 1
     ServicesDefault:
       - OS::TripleO::Services::CACerts
       - OS::TripleO::Services::CephMon
       - OS::TripleO::Services::CephExternal
   ...
       - OS::TripleO::Services::FluentdClient
       - OS::TripleO::Services::VipHosts
       - OS::TripleO::Services::Motd           # Add the service to the end

   Copy to Clipboard Toggle word wrap

4. オーバークラウドの作成時には、編集した環境ファイルと custom_roles_data.yaml ファイルを他の環境ファイルおよびデプロイメントオプションとともに追加します。

   $ openstack overcloud deploy --templates -e /home/stack/templates/env-motd.yaml -r ~/custom_roles_data.yaml [OTHER OPTIONS]

   Copy to Clipboard Toggle word wrap

手順

1. Red Hat Connect for Technology Partners にログインし、Zones をクリックします。
2. 下方向にスクロールして、Red Hat OpenStack & NFV ゾーンを選択します。ボックスのどこかをクリックします。
3. Certify をクリックし、ご自分の会社の既存製品およびプロジェクトにアクセスします。
4. Add Project をクリックし、新規プロジェクトを作成します。

5. Project Name を設定します。

   • プロジェクト名は、システム外には公開されません。
   • プロジェクト名には [product][version]-[extended-base-container-image]-[your-plugin] が含まれている必要があります。
   • OpenStack の場合、フォーマットは rhospXX-baseimage-myplugin です。
   • 例: rhosp13-openstack-cinder-volume-myplugin

6. ご自分の製品またはプラグイン、およびそのバージョンを元に、Product、Product Version、および Release Category を選択します。

   • プロジェクトを作成する前に、製品とそのバージョンを作成します。
   • ラベルのリリースカテゴリーは、Tech Preview に設定します。Red Hat Certification を使用した API テストが完了するまで、Generally Available オプションを選択することはできません。コンテナーイメージが認定されたら、プラグイン認定要件を参照してください。
7. パートナープラグインで変更するベースイメージを元に、Red Hat Product および Red Hat Product Version を選択します。今回のリリースでは、Red Hat OpenStack Platform および 13 を選択してください。
8. Submit をクリックし、新規プロジェクトを作成します。

手順

1. Certification Checklist をクリックします。
2. チェックリストのすべてのセクションを完了します。チェックリストの項目の詳細情報が必要な場合は、左側のドロップダウン矢印をクリックして、項目の情報や他のリソースへのリンクを表示してください。

手順

1. Project Settings をクリックします。

2. プロジェクト名が正しい形式であることを確認します。認定に合格したコンテナーを自動的に公開する場合には、オプションとして Auto-Publish を ON に設定します。認定済みコンテナーは、Red Hat Container Catalog に公開されます。

   

3. Container Registry Namespace を設定して、以下のオンラインの指示に従います。

   

   • コンテナーレジストリー名前空間には、ご自分の会社の名前を設定します。
   • 最終的なレジストリー URL は registry.connect.redhat.com/namespace/repository:tag です。
   • 例: registry.connect.redhat.com/mycompany/rhosp16-openstack-cinder-volume-myplugin:1.0

4. Outbound Repository Name および Outbound Repository Descriptions を設定するには、画面に表示される指示に従ってください。アウトバウンドリポジトリー名は、プロジェクト名と同じでなければなりません。

   

   • [product][version]-[extended_base_container_image]-[your_plugin]
   • OpenStack の場合、フォーマットは rhospXX-baseimage-myplugin です。
   • 最終的なレジストリーの URL は、registry.connect.redhat.com/namespace/repository:tag になります。
   • 例: registry.connect.redhat.com/mycompany/rhosp13-openstack-cinder-volume-myplugin:1.0

5. 該当するフィールドに、プロジェクトに関する補足情報を追加します。

   • Repository Description
   • Supporting Documentation for Primed
6. Submit をクリックします。

手順

1. Build Service をクリックします。

2. Configure Build Service をクリックして、ビルドの詳細を設定します。

   1. Red Hat Container Build を必ず ON に設定します。
   2. Git Source URL を追加します。お使いの git リポジトリーが保護されている場合には、オプションとして Source Code SSH Key を追加します。URL は HTML または SSH を使用できます。保護されている git リポジトリーの場合には、SSH を使用する必要があります。
   3. オプションとして、Dockerfile Name を追加します。Dockerfile の名前が Dockerfile の場合には、空欄のままにします。
   4. (オプション) Docker ビルドのコンテキストルートが git リポジトリーのルートではない場合は、Context Directory を追加します。そうでなければ、このフィールドは空欄のままにします。
   5. コンテナーイメージのベースとする git リポジトリーの Branch を設定します。
   6. Submit をクリックして、Build Service の設定を確定します。
3. Start Build をクリックします。

4. Tag Name を追加し、Submit をクリックします。ビルドが完了するのに、6 分程度かかる場合があります。

   • タグ名は、プラグインのバージョンに設定する必要があります。
   • 最終的な参照先 URL は、registry.connect.redhat.com/namespace/repository:tag になります。
   • 例: registry.connect.redhat.com/mycompany/rhosp13-openstack-cinder-volume-myplugin:1.0
5. Refresh をクリックし、ご自分のビルドが完了したことを確認します。(オプション) 対応する Build ID をクリックして、ビルド情報およびログを表示します。
6. ビルドサービスは、イメージのビルドおよびスキャンの両方を行います。このプロセスには、通常 10 - 15 分かかります。スキャンが完了したら、View リンクをクリックしてスキャン結果を展開します。

手順

1. Container Information のページで View のリンクをクリックし、スキャン結果を展開します。

2. エラーの発生した項目をクリックします。たとえば、次のスクリーンショットでは、 has_licenses のチェックに失敗しています。

   

3. エラーの発生した項目をクリックして Policy Guide の該当するセクションを表示し、問題を修正する方法の詳細を確認します。

手順

1. Container Information のページで、Publish のリンクをクリックしてコンテナーイメージを一般に公開します。
2. Publish のリンクが Unpublish に変わります。コンテナーの公開を取り消すには、Unpublish のリンクをクリックします。

1. registry.connect.redhat.com カタログにログインします。

   $ docker login registry.connect.redhat.com

   Copy to Clipboard Toggle word wrap

2. プラグインをダウンロードします。

   $ docker pull registry.connect.redhat.com/dellemc/openstack-cinder-volume-dellemc-rhosp13

   Copy to Clipboard Toggle word wrap

3. OpenStack デプロイメントに該当するアンダークラウドの IP アドレスを使用して、イメージをタグ付けしてローカルのアンダークラウドレジストリーにプッシュします。

   $ docker tag registry.connect.redhat.com/dellemc/openstack-cinder-volume-dellemc-rhosp13 192.168.24.1:8787/dellemc/openstack-cinder-volume-dellemc-rhosp13
   
   $ docker push 192.168.24.1:8787/dellemc/openstack-cinder-volume-dellemc-rhosp13

   Copy to Clipboard Toggle word wrap

4. 以下のパラメーターが含まれる追加の環境ファイルを指定して、オーバークラウドをデプロイします。

   parameter_defaults:
     DockerCinderVolumeImage: 192.168.24.1:8787/dellemc/openstack-cinder-volume-dellemc-rhosp13

   Copy to Clipboard Toggle word wrap