Skip to main content

Especificación de secretos recomendados para un repositorio

Puedes agregar una configuración a la configuración del contenedor de desarrollo que pedirá a los usuarios que establezcan secretos de entorno de desarrollo específicos al crear un codespace.

¿Quién puede utilizar esta característica?

People with write permissions to a repository can create or edit the codespace configuration.

Si un proyecto necesita que se configuren secretos específicos del usuario, puedes pedir a los usuarios que lo hagan cuando creen un codespace. Para ello, agrega una configuración a un archivo de configuración de contenedor de desarrollo para el repositorio.

Después de especificar secretos recomendados, si los usuarios aún no han creado esos secretos en su configuración personal para Codespaces, se les pedirá que lo hagan cuando usen el método de opciones avanzadas para crear un codespace. Esto se hace en GitHub al hacer clic en el botón Código , luego haciendo clic en la pestaña Codespaces y, a continuación, seleccionando y haciendo clic en Nuevo con opciones.

Captura de pantalla de la lista desplegable de opciones en la pestaña "Codespaces", con la opción "Nuevo con opciones".

Los secretos recomendados se muestran en la parte inferior de la página.

Screenshot of the "Create codespace" page with four recommended secrets highlighted with a dark orange outline.

Note

Los nombres de los secretos recomendados solo aparecen en esta página cuando la configuración del contenedor de la rama seleccionada especifica estos secretos.

Cada secreto recomendado se muestra de una de estas tres maneras:

  • Si la persona no ha establecido el secreto recomendado en su configuración de Codespaces, se muestra un cuadro de entrada, lo que permite crear el secreto ahora. Si se han configurado, se muestra una descripción y un vínculo a más información. La escritura de un valor es opcional.
  • Si la persona ya ha creado el secreto recomendado pero no lo ha asociado a este repositorio, puede activar una casilla para agregar esta asociación. Esto es opcional.
  • Si la persona ya ha creado el secreto recomendado y lo ha asociado a este repositorio, se muestra una casilla preseleccionada.

Debes usar secretos recomendados para los secretos de entorno de desarrollo que debe proporcionar el usuario que crea el codespace, en lugar del propietario del repositorio u organización. Por ejemplo, si tienes un proyecto público y los usuarios deben proporcionar una clave de API personal para ejecutar la aplicación en el proyecto, puedes especificar un secreto recomendado para que se les pida a los usuarios que proporcionen la clave como valor del secreto cuando usen la página de opciones avanzadas para crear un codespace.

Como alternativa, para los secretos de entorno de desarrollo que el propietario del repositorio u organización pueden proporcionar, como las claves de API compartidas en un equipo, puedes establecer secretos en el nivel del repositorio u organización. Para obtener más información, vea «Administración de secretos del entorno de desarrollo para el repositorio o la organización».

  1. Puedes configurar los codespaces creados para el repositorio agregando configuraciones a un archivo devcontainer.json. Si el repositorio aún no contiene un archivo devcontainer.json, puedes agregar uno ahora. Consulte "Incorporación de una configuración de contenedor de desarrollo al repositorio".

  2. Edita el archivo devcontainer.json, agregando la propiedad secrets en el nivel superior del archivo, dentro del objeto JSON envolvente. Por ejemplo:

    JSON
    "secrets": {
      "NAME_OF_SECRET_1": {
        "description": "This is the description of the secret.",
        "documentationUrl": "https://example.com/link/to/info"
      },
      "NAME_OF_SECRET_2": { }
    }
    
  3. Agrega una propiedad dentro de secrets para cada secreto que desees recomendar. Por ejemplo, cambia NAME_OF_SECRET_1 y NAME_OF_SECRET_2, en el ejemplo de código anterior, por los nombres de los secretos que los usuarios deben crear en su configuración personal para Codespaces.

  4. Opcionalmente, proporciona una descripción para cada secreto y una dirección URL para obtener más información sobre este secreto.

    Puedes omitir description y documentationUrl, como muestra NAME_OF_SECRET_2 en el ejemplo de código anterior.

  5. Especifica secretos adicionales, según sea necesario.

  6. Guarda el archivo y confirma tus cambios a la rama requerida del repositorio.

Información adicional