12.2. Ansible ベース Operator の作成

手順

1. リリースバージョン変数を設定します。

   RELEASE_VERSION=v0.12.0

   Copy to Clipboard Toggle word wrap

2. リリースバイナリーをダウンロードします。

   • Linux の場合

     $ curl -OJL https://github.com/operator-framework/operator-sdk/releases/download/${RELEASE_VERSION}/operator-sdk-${RELEASE_VERSION}-x86_64-linux-gnu

     Copy to Clipboard Toggle word wrap

   • MacOS の場合

     $ curl -OJL https://github.com/operator-framework/operator-sdk/releases/download/${RELEASE_VERSION}/operator-sdk-${RELEASE_VERSION}-x86_64-apple-darwin

     Copy to Clipboard Toggle word wrap

3. ダウンロードしたリリースのバイナリーを確認します。

   1. 提供された ASC ファイルをダウンロードします。

      • Linux の場合

        $ curl -OJL https://github.com/operator-framework/operator-sdk/releases/download/${RELEASE_VERSION}/operator-sdk-${RELEASE_VERSION}-x86_64-linux-gnu.asc

        Copy to Clipboard Toggle word wrap

      • MacOS の場合

        $ curl -OJL https://github.com/operator-framework/operator-sdk/releases/download/${RELEASE_VERSION}/operator-sdk-${RELEASE_VERSION}-x86_64-apple-darwin.asc

        Copy to Clipboard Toggle word wrap

   2. バイナリーと対応する ASC ファイルを同じディレクトリーに置き、以下のコマンドを実行してバイナリーを確認します。

      • Linux の場合

        $ gpg --verify operator-sdk-${RELEASE_VERSION}-x86_64-linux-gnu.asc

        Copy to Clipboard Toggle word wrap

      • MacOS の場合

        $ gpg --verify operator-sdk-${RELEASE_VERSION}-x86_64-apple-darwin.asc

        Copy to Clipboard Toggle word wrap

      保守管理者の公開キーがワークステーションにない場合は、以下のエラーが出されます。

      $ gpg --verify operator-sdk-${RELEASE_VERSION}-x86_64-apple-darwin.asc
      $ gpg: assuming signed data in 'operator-sdk-${RELEASE_VERSION}-x86_64-apple-darwin'
      $ gpg: Signature made Fri Apr  5 20:03:22 2019 CEST
      $ gpg:                using RSA key <key_id> 

      1

      
      $ gpg: Can't check signature: No public key

      Copy to Clipboard Toggle word wrap

      1

      RSA キー文字列。

      キーをダウンロードするには、以下のコマンドを実行し、 <key_id> を直前のコマンドの出力で提供された RSA キー文字列に置き換えます。

      $ gpg [--keyserver keys.gnupg.net] --recv-key "<key_id>" 

      1

      Copy to Clipboard Toggle word wrap

      1

      キーサーバーが設定されていない場合、これを --keyserver オプションで指定します。

4. リリースバイナリーを PATH にインストールします。

   • Linux の場合

     $ chmod +x operator-sdk-${RELEASE_VERSION}-x86_64-linux-gnu
     $ sudo cp operator-sdk-${RELEASE_VERSION}-x86_64-linux-gnu /usr/local/bin/operator-sdk
     $ rm operator-sdk-${RELEASE_VERSION}-x86_64-linux-gnu

     Copy to Clipboard Toggle word wrap

   • MacOS の場合

     $ chmod +x operator-sdk-${RELEASE_VERSION}-x86_64-apple-darwin
     $ sudo cp operator-sdk-${RELEASE_VERSION}-x86_64-apple-darwin /usr/local/bin/operator-sdk
     $ rm operator-sdk-${RELEASE_VERSION}-x86_64-apple-darwin

     Copy to Clipboard Toggle word wrap

5. CLI ツールが正しくインストールされていることを確認します。

   $ operator-sdk version

   Copy to Clipboard Toggle word wrap

手順

1. brew コマンドを使用して SDK CLI をインストールします。

   $ brew install operator-sdk

   Copy to Clipboard Toggle word wrap

2. CLI ツールが正しくインストールされていることを確認します。

   $ operator-sdk version

   Copy to Clipboard Toggle word wrap

手順

1. operator-sdk リポジトリーのクローンを作成します。

   $ mkdir -p $GOPATH/src/github.com/operator-framework
   $ cd $GOPATH/src/github.com/operator-framework
   $ git clone https://github.com/operator-framework/operator-sdk
   $ cd operator-sdk

   Copy to Clipboard Toggle word wrap

2. 必要なリリースブランチをチェックアウトします。

   $ git checkout master

   Copy to Clipboard Toggle word wrap

3. SDK CLI ツールをコンパイルし、インストールします。

   $ make dep
   $ make install

   Copy to Clipboard Toggle word wrap

   これにより、$GOPATH/bin に CLI バイナリー operator-sdk がインストールされます。

4. CLI ツールが正しくインストールされていることを確認します。

   $ operator-sdk version

   Copy to Clipboard Toggle word wrap

手順

1. Ansible 2.6+ をインストールします。

   $ sudo yum install ansible

   Copy to Clipboard Toggle word wrap

2. pip を使用して OpenShift python クライアントパッケージをインストールします。

   $ pip install openshift

   Copy to Clipboard Toggle word wrap

手順

1. 新規 Ansible ベースの Operator プロジェクトを初期化します。

   $ operator-sdk new --type ansible --kind Foo --api-version foo.example.com/v1alpha1 foo-operator
   Create foo-operator/tmp/init/galaxy-init.sh
   Create foo-operator/tmp/build/Dockerfile
   Create foo-operator/tmp/build/test-framework/Dockerfile
   Create foo-operator/tmp/build/go-test.sh
   Rendering Ansible Galaxy role [foo-operator/roles/Foo]...
   Cleaning up foo-operator/tmp/init
   Create foo-operator/watches.yaml
   Create foo-operator/deploy/rbac.yaml
   Create foo-operator/deploy/crd.yaml
   Create foo-operator/deploy/cr.yaml
   Create foo-operator/deploy/operator.yaml
   Run git init ...
   Initialized empty Git repository in /home/dymurray/go/src/github.com/dymurray/opsdk/foo-operator/.git/
   Run git init done

   Copy to Clipboard Toggle word wrap

   $ cd foo-operator

   Copy to Clipboard Toggle word wrap

2. 必要な Ansible ロジックを使用して roles/foo/tasks/main.yml ファイルを変更します。この例では、変数の切り替えと共に namespace を作成し、削除します。

   - name: set test namespace to {{ state }}
     k8s:
       api_version: v1
       kind: Namespace
       state: "{{ state }}"
       name: test
     ignore_errors: true 

   1

   Copy to Clipboard Toggle word wrap

   1

   ignore_errors: true を設定することにより、存在しないプロジェクトを削除しても失敗しません。

3. roles/foo/defaults/main.yml ファイルを、デフォルトで state を present に設定するように変更します。

   state: present

   Copy to Clipboard Toggle word wrap

4. 上部ディレクトリーに、Foo ロールを含む Ansible Playbook playbook.yml を作成します。

   - hosts: localhost
     roles:
       - Foo

   Copy to Clipboard Toggle word wrap

5. Playbook を実行します。

   $ ansible-playbook playbook.yml
    [WARNING]: provided hosts list is empty, only localhost is available. Note that the implicit localhost does not match 'all'
   
   PLAY [localhost] ***************************************************************************
   
   PROCEDURE [Gathering Facts] *********************************************************************
   ok: [localhost]
   
   Task [Foo : set test namespace to present]
   changed: [localhost]
   
   PLAY RECAP *********************************************************************************
   localhost                  : ok=2    changed=1    unreachable=0    failed=0

   Copy to Clipboard Toggle word wrap

6. namespace が作成されていることを確認します。

   $ oc get namespace
   NAME          STATUS    AGE
   default       Active    28d
   kube-public   Active    28d
   kube-system   Active    28d
   test          Active    3s

   Copy to Clipboard Toggle word wrap

7. state を absent に設定して Playbook を再実行します。

   $ ansible-playbook playbook.yml --extra-vars state=absent
    [WARNING]: provided hosts list is empty, only localhost is available. Note that the implicit localhost does not match 'all'
   
   PLAY [localhost] ***************************************************************************
   
   PROCEDURE [Gathering Facts] *********************************************************************
   ok: [localhost]
   
   Task [Foo : set test namespace to absent]
   changed: [localhost]
   
   PLAY RECAP *********************************************************************************
   localhost                  : ok=2    changed=1    unreachable=0    failed=0

   Copy to Clipboard Toggle word wrap

8. namespace が削除されていることを確認します。

   $ oc get namespace
   NAME          STATUS    AGE
   default       Active    28d
   kube-public   Active    28d
   kube-system   Active    28d

   Copy to Clipboard Toggle word wrap

手順

1. k8s_status モジュールをインストールするには、ansible.cfg ファイルを、インストール済みの Ansible モジュールを /usr/share/ansible/library/ ディレクトリーで検索するように設定します。

   $ echo "library=/usr/share/ansible/library/" >> /etc/ansible/ansible.cfg

   Copy to Clipboard Toggle word wrap

2. k8s_status.py ファイルを /usr/share/ansible/library/ ディレクトリーに追加します。

   $ wget https://raw.githubusercontent.com/openshift/ocp-release-operator-sdk/master/library/k8s_status.py -O /usr/share/ansible/library/k8s_status.py

   Copy to Clipboard Toggle word wrap