Usar el Editor de Cloud Shell como entorno para crear tu servicio y secreto de Cloud Run. El editor está precargado con las herramientas para
el desarrollo en Cloud.
Sigue estos pasos para crear tu servicio:
En la barra de estado de Cloud Code, haz clic en el nombre del proyecto activo.
En el menú Selección rápida que aparece, selecciona Nueva aplicación y, luego, haz clic en Aplicación de Cloud Run.
En la lista de muestras de Cloud Run, selecciona Python (Flask): Cloud Run.
Selecciona una carpeta para tu muestra y, luego, haz clic en Create New Application.
Después de que el editor de Cloud Shell cargue el servicio en un nuevo espacio de trabajo, visualiza sus archivos en la vista del explorador.
Crea un secreto
Secret Manager te permite almacenar, administrar y acceder a los secretos de forma segura como BLOB binarios o cadenas de texto
Además, administra tus Secrets, lo que significa que no tienes que lidiar con máquinas virtuales ni servicios operativos.
Sigue estos pasos para crear un secreto con la integración de Secret Manager de Cloud Code:
Haz clic en Secret Manager y espera un momento a que se cargue.
Si se te solicita que autorices a Cloud Shell para que realice llamadas a la API de Google Cloud,
haz clic en Autorizar.
Haz clic en addCrear secreto.
Si se te solicita, selecciona tu proyecto de Google Cloud en el selector desplegable.
Si se te solicita, habilita la API de Secret Manager.
En la pestaña Secret Manager - Crear secreto que aparece, ingresa lo siguiente en el campo Nombre:
my-secret
En el campo Valor del secreto, ingresa:
Hello secret!
Haz clic en Crear secreto y aparecerá un mensaje que indicará que tu secreto se creó correctamente.
Agrega un Secret a tu código
Los secretos son ideales para almacenar información de configuración, como la claves de API o certificados TLS que necesita una aplicación en el tiempo de ejecución.
Sigue estos pasos para agregar un Secret a tu código:
Abre la vista de la API de Cloud y selecciona la
API de Secret Manager.
Se abrirá la pestaña de detalles de la API de Google Cloud con la API de Secret Manager como
encabezado.
En la sección Instalar biblioteca cliente, haz clic en la pestaña Python y, luego, en play_arrowEjecutar en terminal.
Esto instalará la biblioteca cliente google-cloud-secret-manager.
Abre requirements.txt
y agrega la siguiente línea al final del archivo:
google-cloud-secret-manager==VERSION_NUMBER
Puedes encontrar el número de versión en la consola después de ejecutar la instalación en el paso anterior. Por ejemplo, la consola podría mostrar lo siguiente:
Successfully installed google-cloud-secret-manager-2.23.1
Tus cambios se guardan automáticamente.
Para obtener el valor más reciente de tu secreto, abre app.py, y copia y pega la siguiente función:después de la función hello:
defaccess_secret_version(secret_version_id):"""Return the value of a secret's version"""fromgoogle.cloudimportsecretmanager# Create the Secret Manager client.client=secretmanager.SecretManagerServiceClient()# Access the secret version.response=client.access_secret_version(name=secret_version_id)# Return the decoded payload.returnresponse.payload.data.decode('UTF-8')
Para llamar a la función access_secret_version, reemplaza la variable de mensaje por lo siguiente:
Si aún tienes abierta la pestaña Secret Manager - Crear secreto, file_copyCopia el ID.
Para obtener el ID de una versión del secreto en cualquier momento, navega a Secret Manager > [SECRET_NAME] > Versiones, mantén el puntero sobre tu versión y haz clic en
Copiar ID de recurso.
Para agregar el ID de versión, reemplaza el marcador de posición <SECRET_VERSION_ID> por el ID de versión que copiaste.
Ejecuta en el emulador de Cloud Run
Para probar tu Secret nuevo, ejecuta tu servicio de Cloud Run de forma local en el emulador de Cloud Run.
Abre el menú
Cloud Code
desde la barra de estado.
Para compilar e implementar tu servicio en el emulador, selecciona Ejecutar en emulador de Cloud Run.
En la pestaña Ejecutar/depurar en el emulador de Cloud Run que aparece, haz clic en Ejecutar.
Cuando se ejecuta la configuración por primera vez, este proceso puede tardar hasta 5 minutos. En el panel Salida se muestra el progreso mientras se compila y se implementa tu app.
Una vez que se haya compilado la app, iníciala haciendo clic en el vínculo de localhost que
aparece en el panel
Output. El valor de tu secreto se muestra debajo del gráfico de éxito.
Visualiza y crea una nueva versión del secreto
En la vista de Secret Manager de Cloud Code, puedes ver tus secretos del proyecto, con acciones para administrarlos.
Visualiza el valor de una versión del Secret
Haz clic en la vista Secret Manager.
Para expandir tu secreto, haz clic en él.
En la carpeta Versiones, haz clic con el botón derecho en la versión numerada cuyo valor deseas ver y selecciona Mostrar valor de la versión.
Ten en cuenta que no puedes editar una versión del secreto. Para actualizar el valor de un Secret, debes crear una versión nueva.
Crea una nueva versión del Secret
El valor de un Secret se almacena en una versión secreta. Un secreto puede tener muchas versiones. Esto es útil en situaciones en las que un Secret cambia. Actualizar un
Secret con una nueva versión significa que no tienes que actualizar tu código.
Haz clic en la vista Secret Manager.
Haz clic con el botón derecho en el nombre de tu secreto y selecciona Crear versión del secreto.
En la pestaña Secret Manager - Crear versión que aparece, ingresa un nuevo valor y haz clic en Crear versión.
Después de que se abra la pestaña Secret Manager - Crear secreto, haz clic en file_copyCopiar para copiar el ID.
Para agregar el ID de versión más reciente, reemplaza la versión actual que aparece en la variable de mensaje en app.py por el ID de versión más reciente que copiaste.
Si siempre quieres que tu código use la versión más reciente, reemplaza el número de versión al final del ID de tu versión con latest.
Visualiza y administra secretos
Inhabilita una versión del Secret
Las versiones del secreto se habilitan de forma predeterminada después de su creación, lo que significa que se pueden a las que se accede. No se puede acceder a un Secret inhabilitado, pero puedes restablecer el acceso a él en cualquier momento.
Para inhabilitar una versión de un Secret, haz lo siguiente:
Haz clic en Cloud Code y, luego, expande la sección Secret Manager.
Para expandir tu secreto, haz clic en él.
En la carpeta Versiones, haz clic con el botón derecho en la versión numerada que deseas inhabilitar.
Selecciona Inhabilitar versión.
Destruye una versión del secreto
Cuando destruyes una versión de un Secret, no se puede acceder a ella. Destruir una versión de secreto es permanente.
Haz clic en Cloud Code y, luego, expande la sección Secret Manager.
Para expandir tu secreto, haz clic en él.
En la carpeta Versiones, haz clic con el botón derecho en la versión que deseas destruir.
Selecciona Destruir versión.
Realiza una limpieza
Si deseas borrar solo el clúster que creaste para esta guía de inicio rápido, haz lo siguiente:
Haz clic en Cloud Code y, luego, expande la sección Kubernetes.
Mantén el puntero sobre el nombre de tu clúster y, luego, haz clic en
open_in_newAbrir en la Google Cloud consola.
Haz clic en Borrar y, luego, en Borrar.
Para borrar tu proyecto (y los recursos asociados, incluidos los clústeres), sigue estos pasos:
Ve a la página Proyectos en la Google Cloud consola:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eThis guide explains how to use Cloud Code's Secret Manager integration to create, store, and manage secrets within your Google Cloud project.\u003c/p\u003e\n"],["\u003cp\u003eYou will learn how to create a secret, add it to your application code, and access its value at runtime using the Secret Manager API.\u003c/p\u003e\n"],["\u003cp\u003eThe guide demonstrates how to use the Cloud Run emulator to test your application locally after adding the secret, ensuring your secret is accessed correctly.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage different versions of a secret, view their values, and disable or destroy specific secret versions as needed, allowing you to update your secrets without changing your code.\u003c/p\u003e\n"],["\u003cp\u003eInstructions are included on how to clean up resources by deleting either the cluster or the entire project created for this process, once you are done with the tutorial.\u003c/p\u003e\n"]]],[],null,["Learn how to create and manage secrets using Cloud Code's Secret Manager\nintegration.\n\n*** ** * ** ***\n\nTo follow step-by-step guidance for this task directly in the\nCloud Shell Editor, click **Guide me**:\n\n[Guide me](https://console.cloud.google.com/?walkthrough_id=shell--secret_manager_cloud_code_create_secret)\n\n*** ** * ** ***\n\nBefore you begin\n\n1. In the Google Cloud console, go to the project selector page.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n2. Select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\nCreate your Cloud Run service\n3. Use Cloud Shell Editor as your environment for creating your Cloud Run service and secret. The editor comes preloaded with the tools needed for cloud development.\n4. To create your service:\n 1. In the Cloud Code status bar, click the active project name.\n\n 2. In the Quick Pick menu that appears, select click **New Application** , and\n then click **Cloud Run Application**.\n\n 3. From the list of Cloud Run samples, select **Python (Flask): Cloud Run**.\n\n 4. Select a folder for your sample and then click **Create New Application**.\n\n5. After Cloud Shell Editor loads your service in a new workspace, view its files in the explorer view.\n\nCreate a secret\n6. [Secret Manager](https://cloud.google.com/secret-manager/) allows you to securely store, manage, and access secrets as binary blobs or text strings. Additionally, it manages your secrets, meaning you don't have to deal with virtual machines or operating services.\n7. To create a secret with Cloud Code's Secret Manager integration:\n 1. Click Secret Manager and give it a moment to load.\n 2. If prompted to authorize Cloud Shell to make Google Cloud API calls, click **Authorize**.\n 3. Click add Create Secret.\n 4. If prompted, select your Google Cloud project from the dropdown selector.\n 5. If prompted, enable the Secret Manager API.\n 6. In the **Secret Manager - Create Secret** tab that appears, enter the\n following in the **Name** field:\n\n my-secret\n\n 7. In the **Secret Value** field, enter:\n\n Hello secret!\n\n 8. Click **Create Secret** and a message that your secret was successfully\n created appears.\n\nAdd a secret to your code\n8. Secrets are great for storing configuration information such as database passwords, API keys, or TLS certificates needed by an application at runtime.\n9. To add a secret to your code:\n 1. Open the\n Cloud API view and select the\n Secret Manager API.\n\n This opens a Google Cloud API Detail tab with **Secret Manager API** as the\n heading.\n 2. In the **Install Client Library** section, click the **Python** tab and\n click play_arrow **Run in terminal** .\n This installs the `google-cloud-secret-manager` client library.\n\n 3. Open\n requirements.txt\n and add the following line to the bottom of the file:\n\n google-cloud-secret-manager==\u003cvar translate=\"no\"\u003eVERSION_NUMBER\u003c/var\u003e\n\n You can find the version number in the console after you run the\n installation in the previous step. For example, the console might show:\n `Successfully installed google-cloud-secret-manager-2.23.1`\n\n Your changes are automatically saved.\n 4. To get the latest value of your secret, open\n app.py\n and copy and paste the following function:\n after the hello function:\n\n def access_secret_version(secret_version_id):\n \"\"\"Return the value of a secret's version\"\"\"\n from google.cloud import secretmanager\n\n # Create the Secret Manager client.\n client = secretmanager.https://cloud.google.com/python/docs/reference/secretmanager/latest/google.cloud.secretmanager_v1.services.secret_manager_service.SecretManagerServiceClient.html()\n\n # Access the secret version.\n response = client.https://cloud.google.com/python/docs/reference/secretmanager/latest/google.cloud.secretmanager_v1.services.secret_manager_service.SecretManagerServiceClient.html#google_cloud_secretmanager_v1_services_secret_manager_service_SecretManagerServiceClient_access_secret_version(name=secret_version_id)\n\n # Return the decoded payload.\n return response.payload.data.decode('UTF-8')\n\n 5. To call the `access_secret_version` function, replace the\n message variable\n with the following:\n\n message = access_secret_version(\"\u003cSECRET_VERSION_ID\u003e\")\n\n 6. If you still have the **Secret Manager - Create Secret** tab open,\n file_copy **Copy** the ID.\n\n To get the ID of a secret version at any time, navigate to\n Secret Manager \\\u003e \\[SECRET_NAME\\] \\\u003e Versions, hold the\n pointer over over your version, and click\n\n **Copy resource ID**.\n 7. To add the version ID, replace the placeholder\n `\u003cSECRET_VERSION_ID\u003e`\n with your copied version ID.\n\nRun on Cloud Run emulator\n10. To test your new secret, run your Cloud Run service locally on the Cloud Run emulator.\n 1. Launch the Cloud Code menu from the status bar.\n 2. To build and deploy your service to the emulator, select **Run\n on Cloud Run Emulator**.\n 3. In the Run/Debug on Cloud Run Emulator tab that appears, click **Run**.\n 4. When running the configuration for the first time, this process can take up\n to 5 minutes. The\n **Output**\n panel displays the progress as your app is built and deployed.\n\n 5. After your app is built, launch your app by clicking the localhost link that\n appears in your\n **Output**\n panel. Your secret's value is displayed under the success graphic.\n\nView and create a new secret version\n11. Cloud Code's Secret Manager view gives you a quick look at your project's secrets, with actions for managing them.\n\nViewing the value of a secret version\n 1. Click the Secret Manager view.\n 2. Expand your secret by clicking on it.\n 3. In the **Versions** folder, right-click the numbered version that you want to view the value of and select **Show Version Value**.\n12. Note that you can't edit a secret version. To update a secret's value, you must create a new *version*.\n\nCreate a new secret version\n13. The value of a secret is stored in a secret version. A secret can have many versions. This is helpful in situations where a secret changes. Updating a secret with a new version means you don't have to update your code.\n 1. Click the Secret Manager view.\n 2. Right-click your secret's name and select **Create Secret Version**.\n 3. In the **Secret Manager - Create Version** tab that appears, enter a new value and click **Create Version**.\n 4. After the **Secret Manager - Create Secret** tab opens, click file_copy **Copy** top copy the ID.\n 5. To add the newer version ID, replace the current version that appears the message variable in app.py with the newer version ID that you copied.\n14. If you always want your code to use the latest version, replace the version number at the end of your version ID with `latest`.\n\nView and manage secrets\n\nDisable a secret version\n15. Secret versions are enabled by default after creation, meaning they can be accessed. A disabled secret is inaccessible, but you can always restore access to it at any time.\n16. To disable a secret version:\n 1. Click **Cloud Code** and then expand the **Secret Manager** section.\n 2. Expand your secret by clicking on it.\n 3. Under the **Versions** folder, right-click the numbered version you want to disable.\n 4. Select **Disable Version**.\n\nDestroy a secret version\n17. When you destroy a secret version, it can't be accessed. Destroying a secret version is permanent.\n 1. Click **Cloud Code** and then expand the **Secret Manager** section.\n 2. Expand your secret by clicking on it.\n 3. Under the **Versions** folder, right-click the version you want to destroy.\n 4. Select **Destroy Version**.\n\nCleaning up\n18. To delete just the cluster you created for this quickstart:\n 1. Click **Cloud Code** and then expand the **Kubernetes** section.\n 2. Hold the pointer over your cluster name and then click open_in_new **Open in Google Cloud console**.\n 3. Click **Delete** and then click **Delete**.\n19. To delete your project (and associated resources, including any clusters):\n 1. Go to the Projects page in the Google Cloud console:\n\n [Go to the Projects page](https://console.cloud.google.com/project)\n 2. Select the project that you created for this quickstart and then click\n **Delete**.\n\n 3. Type the project ID to confirm and then click **Shut down**.\n\n This shuts down the project and schedules it for deletion."]]
Cloud Code y, luego, expande la sección Secret Manager.