Serverless App Engine:saectl ツールを使用したシークレットの管理

前提条件

saectl ツールがインストール済みであること。また、AccessKey ID、AccessKey Secret、およびアプリケーションがデプロイされているリージョンが設定済みであること。詳細については、「saectl ツールのインストールと設定」をご参照ください。

シークレットの管理

saectl ツールを使用して、シークレットの作成、表示、更新、削除ができます。

シークレットの作成

1. secret.yaml という名前の設定ファイルを作成します。以下にサンプルコードを示します。各設定項目の詳細については、「Kubernetes YAML 設定項目」をご参照ください。

   apiVersion: v1
   data:
     .dockerconfigjson: xxxxxxxx
   kind: Secret
   metadata:
     name: test
     namespace: default
   type: kubernetes.io/dockerconfigjson

2. secret.yaml ファイルが含まれるディレクトリで、次のコマンドを実行してアプリケーションのシークレットを作成します。

   saectl apply -f secret.yaml

シークレットのリスト表示

saectl get secret ${secret-name} -n ${namespace}
# ${secret-name} はシークレットの名前です。名前を指定しない場合、範囲内のすべてのシークレットが返されます。
# ${namespace} は名前空間 ID です。-n パラメーターで名前空間を指定しない場合、デフォルトの名前空間が使用されます。

出力フィールドの説明を次の表に示します。

シークレット詳細の表示

get または describe コマンドを使用して、シークレットの詳細を表示できます。出力にはシークレットの設定項目が含まれます。詳細については、「Kubernetes YAML 設定項目」をご参照ください。

get コマンドを使用したシークレット設定の表示

saectl get secret ${secret-name} -o {yaml | json} -n ${namespace}
# ${secret-name} はシークレットの名前です。
# -o パラメーターは出力のフォーマットを指定します。
# ${namespace} は名前空間 ID です。-n パラメーターで名前空間を指定しない場合、デフォルトの名前空間が使用されます。

describe コマンドを使用したシークレット詳細の表示

saectl describe secret ${secret-name} -n ${namespace}
# ${secret-name} はシークレットの名前です。
# ${namespace} は名前空間 ID です。-n パラメーターで名前空間を指定しない場合、デフォルトの名前空間が使用されます。

シークレットの更新

edit または apply コマンドを使用してシークレットを更新できます。

edit コマンドを使用したシークレット設定のオンライン編集

1. 次のコマンドを実行します。指定したシークレットの設定が YAML ファイルで開きます。

   saectl edit secret ${secret-name} -n ${namespace}
   # ${secret-name} はシークレットの名前です。
   # ${namespace} は名前空間 ID です。-n パラメーターで名前空間を指定しない場合、デフォルトの名前空間が使用されます。

2. 開いた YAML ファイルで、必要に応じて設定を変更します。ファイルを保存して閉じると、変更が有効になります。

apply コマンドを使用した YAML ファイルからのシークレット更新

secret.yaml 設定ファイルを変更します。ファイルが含まれるディレクトリで、次のコマンドを実行してシークレットを更新します。

saectl apply -f secret.yaml

シークレットの削除

saectl delete secret ${secret-name} -n ${namespace}
# ${secret-name} はシークレットの名前です。
# ${namespace} は名前空間 ID です。-n パラメーターで名前空間を指定しない場合、デフォルトの名前空間が使用されます。

Kubernetes YAML 設定項目

SAE のシークレットは、Kubernetes の Secret リソースタイプに対応します。次の表に、関連する Kubernetes YAML 設定項目を示します。

data:
  .dockerconfigjson: xxxxxx # 値は Base64 でエンコードする必要があります。