Service Account を作成削除する Ansible Playbook

motoishi written 3か月 ago

お疲れ様です。
　
　

今回は、KubernetesのService Account 作成削除する Ansible Playbook を紹介していきたいと思います。
　
Playbook は主に2種類の設定ファイル（インベントリ、プレイブック）から構成することが多いですが、今回紹介するのは1つの Playbook(yamlファイル) で完結するものになります。
　

Ansible Playbook とは

Ansible Playbook は、指定したインベントリーやホストのグループに対して自動的に実行されるタスクのリストです。1 つまたは複数の Ansible タスクを組み合わせて play (特定のホストにマッピングされたタスクの順序付けられたグループ) を作ることができ、タスクは書かれた順序で実行されます。Playbook には 1 つ以上の play を含めることができます。

タスクはモジュール単位で実行されます。各モジュールは Playbook の中で特定のタスクを実行します。モジュールには、タスクを実行するタイミングと場所、そしてタスクを実行するユーザーを決定するメタデータが含まれています。数千もの Ansible モジュールがあり、次のようなあらゆる種類の IT タスクを実行します。

引用 Red Hat 公式サイト
　

今回の記事では、Ansible の Playbook について書いていますが、Ansible を知らない方やPlaybook について不明点がある方に向けて、Ansible の基本的な使い方なども紹介していますので、以下の記事を参考にしてみてください。
　

◆Ansibleを利用してnginxをインストール・起動してみる
https://cloud5.jp/saitou-ansible-nginx-install/
　

処理概要

以下は処理概要を示した図になります。

Playbook の詳細

Service Account の作成削除を行う Playbook の詳細です。Vars で定義された変数を調整することで、同じ Playbook を何度も再利用することができます。

---
- name: Manage ServiceAccount with IAM Role
  hosts: localhost
  gather_facts: no
  vars:
    serviceaccount_name: playbook-serviceaccount
    serviceaccount_namespace: test-playbook-serviceaccount
    serviceaccount_state: present
    eks_role_arn: arn:aws:iam::XXXXXXXXXXXX:role/AdministratorsAccessRole
    kubeconfig: /home/test/.kube/config

  tasks:
    - name: Create ServiceAccount
      k8s:
        name: "{{ serviceaccount_name }}"
        namespace: "{{ serviceaccount_namespace }}"
        kind: ServiceAccount
        state: "{{ serviceaccount_state }}"
        kubeconfig: "{{ kubeconfig }}"
      register: serviceaccount_result
      when: serviceaccount_state == 'present'

    - name: Add IAM Role Annotation to ServiceAccount
      k8s:
        state: present
        name: "{{ serviceaccount_name }}"
        namespace: "{{ serviceaccount_namespace }}"
        kind: ServiceAccount
        definition:
          apiVersion: v1
          kind: ServiceAccount
          metadata:
            name: "{{ serviceaccount_name }}"
            annotations:
              eks.amazonaws.com/role-arn: "{{ eks_role_arn }}"
        kubeconfig: "{{ kubeconfig }}"
      when: serviceaccount_state == 'present'

    - name: Delete ServiceAccount
      k8s:
        name: "{{ serviceaccount_name }}"
        namespace: "{{ serviceaccount_namespace }}"
        kind: ServiceAccount
        state: absent
        kubeconfig: "{{ kubeconfig }}"
      when: serviceaccount_state == 'absent'

　
8行目 : serviceaccount_state: Service Accountを作成する場合は ‘present’ を指定し、削除する場合は ‘absent’ を指定します

14行目 : k8s は Ansible のKubernetesモジュールを使用してKubernetesリソースを管理するためのモジュールです。Red Hat がサポートしているので利用しています

21.37行目 : タスクを実行する条件を指定しています。serviceaccount_stateが’present’（存在する）場合にのみタスクが実行されるように設定しています

46行目 : タスクを実行する条件を指定しています。serviceaccount_stateが’absent’（存在しない）場合にのみタスクが実行されるように設定しています

まとめ

Ansible Playbook を使用して、Kubernetes上の Service Account の作成と削除を管理する方法を紹介しました。
　
Ansible は自動化に優れたツールであり Playbook を使えば、Kubernetes クラスター内のリソースを効率的に管理できます。
　
Playbook は、複数のフォルダ構成を使用して実行することができ、効率的に再利用することができます。例えば、共通の役割（roles）を持つ Playbook や、異なる環境用の変数（vars）を持つ複数の Playbook を作成することができます。
　
Ansibleの柔軟性を活かして、より効率的にリソースを管理できるよう、複数のフォルダ構成を使った実行方法を試してみてください。
　

◆ Ansibleを利用してnginxをインストール・起動してみる
https://cloud5.jp/saitou-ansible-nginx-install/

◆ EKSクラスター内のPODからkubectlコマンドを使用してS3コマンド実行
https://cloud5.jp/mk-kubectl-eks-pod-s3/

Service Account を作成削除する Ansible Playbook

Ansible Playbook とは

処理概要

Playbook の詳細

まとめ

Author