Appearance
Secret の登録
ここでは、AssemblyLineを実行するために必要なパラメータとして、Secretを登録します。
Deployment Secretの登録
Qmonus Value Streamでは、Deployment Secret編集画面を通して各アプリケーションで利用する機密情報を、ユーザが利用する機密情報の管理サービス (e.g. GCPのSecret Manager, AzureのKey Vault, etc.)に保存できます。 そして、その登録した機密情報の名前をAssemblyLineからのパイプラインステージを実行する際の引数として利用できます。
また、AssemblyLine manifestの各パイプラインステージに記述したパラメータバインディング定義（spec.annotations）を評価して実際にPipelineに渡される値、および定義が漏れている値を、AssemblyLineの詳細画面から確認できます。 これらの機能を用いて、Pipelineの実行パラメータを検証しながら機密情報を設定できます。
Deployment Secretを設定する主な流れは以下のとおりです。
- AssemblyLineの詳細画面にて、各パイプラインステージのSecretsとして表示されているPipeline実行時引数が正しく設定されていることを確認します。
- 設定されたPipeline実行時引数に不足もしくは誤りがある場合、Deployment Secretの設定を修正します。
- 再度AssemblyLineの詳細画面を確認し、Deployment Secretの修正により、実行時引数が正しく設定されていることを確認します。まだ不備がある場合は、再度Deployment Secretを修正します。
Secretの確認
AssemblyLineの詳細画面にて、実際にSecretsとして表示されているPipeline実行時引数の値を確認します。
- 実行したいAssemblyLineの詳細画面を開きます。
- パイプラインステージを選択します。
- パイプラインステージで実行されるPipelineに必要な機密情報と、設定された値が表示されます。
| 項目 | 詳細 |
|---|---|
| Name | Pipelineの実行時引数のkey |
| Key | 機密情報の管理サービスにおいて登録されている機密情報の名前 |
| Version | Keyに表示された機密情報のバージョンおよび作成日 |
Deployment Secretの設定
Pipelineの実行時引数として利用する値は、Deployment Secretに機密情報の管理サービスにおいて登録されている機密情報の名前およびそのバージョンを設定することで追加されます。
- AssemblyLineの詳細画面にて、Deployment Secretを設定したいパイプラインステージを選択します。
- 画面中部に存在する、
EDIT DEPLOYMENT SECRETを押下します。 - 設定画面が表示されますので、まず
Privider TypeとBackend IDを入力し、SYNC SECRET BACKENDを押下します。 - 上記が正常に完了すれば、上記で設定した機密情報の管理サービスにおいて登録された情報が選択できるようになるため、
KeyとVersionを設定します。 - 設定内容が正しいことを確認し、保存します。
- AssemblyLineの詳細画面を確認し、Secretsに表示された実行時引数が正しく設定されていることを確認します。
登録したSecretの利用
機密情報の管理サービスに登録された機密情報をアプリケーションで利用するには、External Secret Operatorを利用してください。 External Secret Operatorを利用することで、機密情報の管理サービスに登録された機密情報をKubernetesのsecretリソースとして利用できるようになります。 最終的にアプリケーションでは、External Secret Operatorによって作成されたKubernetesのsecretリソースをmountすることで、Qmonus Value Streamにおいて設定した機密情報の値を利用できます。
External Secret Operatorの詳細と導入に関しては応用編 : 機密情報管理を参考にしてください。