透過 Cloud Code 的 Secret Manager 整合功能,您可以在 IDE 中建立、查看、更新及使用 Secret,不必將 Secret 儲存在程式碼集區中。
本頁說明如何在 IDE 中存取 Secret Manager,以及如何開始建立及管理密鑰。
啟用 Secret Manager API
使用 Cloud Code 管理密鑰時,密鑰會安全地儲存在 Secret Manager 中,並可在需要時以程式輔助方式擷取。您只需要啟用 Secret Manager API,並具備管理密鑰的適當權限:
請確認您正在處理應用程式程式碼所在的專案。Secret 必須與應用程式程式碼位於相同專案。
按一下
「Cloud Code」,然後展開「Secret Manager」探索工具。
如果尚未啟用 Secret Manager API,請在 Secret Manager 瀏覽器中按一下「啟用 Secret Manager API」。
建立密鑰
如要使用 Secret Manager 探索器建立密鑰,請按照下列步驟操作:
在 IDE 中,依序點選
「Cloud Code」和「Secret Manager」 探索工具。
在「Secret Manager」瀏覽器中,按一下「新增」建立密鑰。
在「建立密鑰」對話方塊中,設定密鑰的專案、名稱、值和區域,並指定標籤來整理密鑰。
或者,您也可以使用編輯器建立密鑰:
- 在編輯器中開啟含有要儲存為密鑰的文字的檔案。
- 選取要儲存為密鑰的文字,然後按一下滑鼠右鍵,並點選「在 Secret Manager 中建立密鑰」。
- 在「建立密鑰」對話方塊中,自訂密鑰的專案、名稱、值、區域和標籤。
建立密鑰的新版本
如要使用 Secret Manager 建立新的密鑰版本,請按照下列步驟操作:
在現有 Secret 上按一下滑鼠右鍵,然後選擇「建立 Secret 版本」。
在「建立版本」對話方塊中,使用「Secret 值」欄位或匯入檔案,設定現有 Secret 的新值。
如要移除密鑰的所有舊版本,只保留您建立的新版本,請選擇「停用所有舊版本」。
按一下「Create version」(建立版本)。系統會新增版本,您可以在「版本」下拉式選單下方,查看最新和先前的密鑰版本。
或者,您也可以在編輯器中建立新的密鑰版本:
在編輯器中開啟檔案,然後反白選取要儲存為密鑰的文字。
在醒目顯示的文字上按一下滑鼠右鍵,然後選擇「Add Version to Secret in Secret Manager」(在 Secret Manager 中將版本新增至密鑰)。
管理密鑰版本
如要啟用、停用或刪除某版本的 Secret,請在該 Secret 上按一下滑鼠右鍵,然後選取要執行的動作指令。您也可以查看已啟用密鑰版本的值。
查看密鑰
如要查看密鑰,請在「Secret Manager」檔案總管中,從清單選取密鑰。密鑰名稱下方會列出密鑰詳細資料,例如名稱、複製政策、建立時間戳記和資源 ID。
在 Google Cloud 控制台中查看密鑰
或者,您也可以在 Google Cloud 控制台中查看密鑰,方法是在「Secret Manager」檔案總管中對密鑰按一下滑鼠右鍵,然後點選「Open in Cloud console」(在 Cloud 控制台中開啟)。
在 Kubernetes 探索器中查看 Secret
如要在 Kubernetes 探索器中查看密鑰,請按照下列步驟操作:
- 按一下
「Cloud Code」,然後展開「Kubernetes」探索工具。
- 展開叢集,然後展開「Secrets」。
- 展開密鑰即可查看詳細資料。
從應用程式存取密鑰
建立密鑰後,您可以在程式碼中加入密鑰,並設定驗證。
如要從應用程式存取密鑰,請按照下列步驟操作:
安裝 Secret Manager 用戶端程式庫。
按一下
「Cloud Code」,然後展開「Cloud APIs」探索工具。
依序展開「Cloud Security」>「Secret Manager API」,然後按照「Install Client Library」一節中的操作說明,為您使用的語言安裝用戶端程式庫。
在應用程式的程式碼中,自訂並加入相關程式碼片段。
如要取得密鑰版本名稱以用於程式碼中,請在「Secret Manager」面板中選取密鑰,按一下滑鼠右鍵,然後選擇「Copy Resource ID」(複製資源 ID)。
如要完成驗證設定,請參閱用戶端程式庫驗證指南:
將密鑰新增為環境變數
如要將現有的 Kubernetes Secret 以環境變數的形式新增至部署作業,請按照下列步驟操作:
- 按一下
「Cloud Code」,然後展開「Kubernetes」探索工具。
- 展開 minikube 叢集,然後展開「Secrets」。
- 在代表部署物件的 Secret 上按一下滑鼠右鍵,然後點選「Add Secret as Environment Variable」(將 Secret 新增為環境變數)。
將密鑰掛接為磁碟區
如要將現有的 Kubernetes Secret 掛接為部署作業容器中的磁碟區,請按照下列步驟操作:
- 按一下
「Cloud Code」,然後展開「Kubernetes」探索工具。
- 展開 minikube 叢集,然後展開「Secrets」。
- 在代表部署物件的 Secret 上按一下滑鼠右鍵,然後點選「將 Secret 掛接為磁碟區」。
刪除 Secret
如要使用 Cloud Code 中的 Secret Manager 刪除密鑰,請按照下列步驟操作:
按一下
「Cloud Code」,然後展開「Secret Manager」探索工具。
在現有密碼上按一下滑鼠右鍵,然後選取「Open in Cloud Console」(在 Cloud 控制台中開啟)。
在「Secret details」(密鑰詳細資料) 頁面中,按一下「DELETE」(刪除),然後按照提示刪除密鑰。