リソース定義@Secrets ストア CSI ドライバー¶
はじめに¶
本サイトにつきまして、【IT技術の知見】はじめに - 俺の技術ノート をご認識のほど宜しくお願いいたします。
01. セットアップ¶
インストール¶
▼ チャートとして¶
チャートリポジトリからチャートをインストールし、Kubernetes リソースを作成する。
$ helm repo add <チャートリポジトリ名> https://kubernetes-sigs.github.io/secrets-store-csi-driver/charts
$ helm repo update
$ helm install <Helmリリース名> <チャートリポジトリ名>/secrets-store-csi-driver -n kube-system --version <バージョンタグ>
▼ Amazon EKS 専用のチャートとして¶
Amazon EKS で Secrets ストア CSI ドライバーを簡単にセットアップするために、それ専用のチャートを使用する。
$ helm repo add <チャートリポジトリ名> https://kubernetes-sigs.github.io/secrets-store-csi-driver/charts
$ helm repo update
$ helm install <Helmリリース名> <チャートリポジトリ名>/secrets-store-csi-driver -n kube-system --version <バージョンタグ>
また、Amazon EKS のために必要なマニフェストをインストールする。
$ kubectl apply -f https://raw.githubusercontent.com/aws/secrets-store-csi-driver-provider-aws/main/deployment/aws-provider-installer.yaml
02. Pod@Kubernetes での設定¶
Secrets ストア CSI ドライバーによって、Pod では Secret を介さずに、プロバイダーから変数を直接的にマウントする。
別途、Pod に紐づく ServiceAccount へ、プロバイダーの Secret への認可スコープを付与する必要がある。
apiVersion: v1
kind: Pod
metadata:
name: foo-pod
namespace: foo-namespace
spec:
containers:
- name: app
image: app:1.0.0
ports:
- containerPort: 8080
# Secret は使用せずに Pod 内コンテナにファイルとしてマウントする。
volumeMounts:
- name: foo-secrets-store-csi-volume
mountPath: /etc/secrets
readOnly: true
volumes:
# CSI ボリュームを設定する。
- name: foo-secrets-store-csi-volume
csi:
driver: secrets-store.csi.k8s.io
readOnly: true
volumeAttributes:
# SecretProviderClass を指定する。
secretProviderClass: foo-aws-secret-provider-class
03. SecretProviderClass¶
.metadata¶
▼ namespace¶
Namespace を設定する。
Secret のマウント対象となる Pod と、同じ Namespace にする必要がある。
apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
namespace: foo-namespace # Pod と同じ Namespace
.spec.provider¶
▼ provider とは¶
Secret のプロバイダーを設定する。
apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
name: foo-aws-secret-provider-class
spec:
provider: aws
.spec.parameters¶
▼ parameters とは¶
プロバイダーに応じて、参照する Secret のデータを設定する。
▼ objects (AWS プロバイダーの場合)¶
AWS プロバイダー上の Secret (AWS Secrets Manager、AWS Systems Manager) を識別する情報を設定する。
apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
name: foo-aws-secret-provider-class
spec:
provider: aws
parameters:
# AWS Secrets Manager から取得する。
# objectName キーに、ARN (arn:aws:secretsmanager:ap-northeast-1:<AWS アカウント ID>:secret:<Secret ストア名>) を指定しても良い。
# その場合、objectType キーは不要になる。
objects: |
- objectName: "<Secret名>"
- objectType: "secretsmanager"
apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
name: foo-aws-secret-provider-class
spec:
provider: aws
parameters:
# AWS Systems Manager から取得する。
objects: |
- objectName: "/foo/USERNAME"
objectType: "ssmparameter"
- objectName: "/foo/PASSWORD"
objectType: "ssmparameter"
▼ objects (Google Cloud プロバイダーの場合)¶
Google Cloud プロバイダー上の Secret (Google Cloud Secret Manager) を識別する情報を設定する。
apiVersion: secrets-store.csi.x-k8s.io/v1
kind: SecretProviderClass
metadata:
name: foo-gcp-secret-provider-class
spec:
provider: gcp
parameters:
# Google Cloud Secret Manager から取得する。
objects: |
- resourceName: "projects/<プロジェクトID>/secrets/<Secret名>"