Crea una instancia y accede a ella

Crea una instancia y accede a ella

Crea una instancia de Secure Source Manager y accede a su interfaz web para prepararte para crear repositorios y otorgar acceso a los usuarios.

Nota: Secure Source Manager no admite proyectos con alcance de dominio. Si tu ID del proyecto contiene dos puntos (:), debes crear un proyecto nuevo antes de usar Secure Source Manager.

Antes de comenzar

Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Instala Google Cloud CLI.

Nota: Si ya instalaste gcloud CLI, asegúrate de tener la versión más reciente ejecutando gcloud components update.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Crea o selecciona un Google Cloud proyecto.

Roles obligatorios para seleccionar o crear un proyecto

• Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos creados durante este procedimiento, crea un proyecto en lugar de seleccionar un proyecto existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Para crear un Google Cloud proyecto, haz lo siguiente:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto que estás creando.

• Selecciona el Google Cloud proyecto que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre del Google Cloud proyecto.

Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

Habilita la API de Secure Source Manager, si aún no está habilitada:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

gcloud services enable securesourcemanager.googleapis.com

Instala Google Cloud CLI.

Nota: Si ya instalaste gcloud CLI, asegúrate de tener la versión más reciente ejecutando gcloud components update.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Crea o selecciona un Google Cloud proyecto.

Roles obligatorios para seleccionar o crear un proyecto

• Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos creados durante este procedimiento, crea un proyecto en lugar de seleccionar un proyecto existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Para crear un Google Cloud proyecto, haz lo siguiente:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto que estás creando.

• Selecciona el Google Cloud proyecto que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre del Google Cloud proyecto.

Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

Habilita la API de Secure Source Manager, si aún no está habilitada:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

gcloud services enable securesourcemanager.googleapis.com

Roles obligatorios

Para obtener los permisos que necesitas para crear una instancia de Secure Source Manager, pídele a tu administrador que te otorgue el rol de IAM Propietario de la instancia (roles/securesourcemanager.instanceOwner) en el Google Cloud proyecto.

Nota: El rol de administrador de Secure Source Manager (roles/securesourcemanager.admin) o el rol básico de IAM de propietario (roles/owner) en tu proyecto también contiene permisos para crear una instancia. No deberías otorgar roles de administrador ni roles básicos en un entorno de producción, pero puedes otorgarlos en un entorno de desarrollo o de prueba.

Los roles de Secure Source Manager no aparecen en la Google Cloud consola hasta que se otorgan a una principal. Para otorgar un rol de Secure Source Manager por primera vez, consulta Cómo otorgar y revocar roles de IAM.

Crea una instancia

1. Ejecuta el siguiente comando para crear una instancia llamada my-instance en la us-central1 ubicación. Es posible que se te solicite que te autentiques en gcloud CLI.

   gcloud source-manager instances create my-instance \
       --region=us-central1
   

   Aquí:

   • my-instance es el nombre de la instancia.
   • us-central1 es la región en la que se creará la instancia.

   Se inicia una operación de larga duración para crear la instancia. El resultado se ve de la siguiente manera:

   Create request issued for [my-instance].
   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata
     apiVersion: v1
     createTime: '2023-02-27T20:57:52.315609549Z'
     requestedCancellation: false
     target: projects/PROJECT_ID/locations/us-central1/instances/my-instance
     verb: create
   name: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e
   

   La creación de la instancia puede demorar hasta 60 minutos.

2. Ten en cuenta el OPERATION_NAME, que es el nombre completo del recurso de la operación que se recibió en respuesta a tu solicitud. Tiene el siguiente formato y es obligatorio cuando se verifica el estado de la operación en el siguiente paso:

   projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

   Por ejemplo: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e donde PROJECT_ID es tu Google Cloud proyecto.

3. Para verificar el estado de la operación create, ejecuta el siguiente comando:

   gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

   Reemplaza OPERATION_NAME por el nombre de la operación que se muestra en la respuesta del comando create.

   Una vez que la instancia esté lista, la respuesta se verá de la siguiente manera:

   {
   "name": "projects/PROJECT_ID/locations/us-central1/operations/operation-123456789012-5ec69948c0f2b-60dd727f-a9b97a2e",
   "metadata": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
     "createTime": "2022-11-01T14:31:32.420469714Z",
     "endTime": "2022-11-01T14:48:34.140378114Z",
     "target": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "verb": "create",
     "requestedCancellation": false,
     "apiVersion": "v1"
   },
   "done": true,
   "response": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Instance",
     "name": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "createTime": "2022-11-01T14:31:32.416413630Z",
     "updateTime": "2022-11-01T14:31:32.416413630Z"
     },
     "state": "ACTIVE",
     "hostConfig": {
       "html": "my-instance-098765432109.us-central1.sourcemanager.dev",
       "api": "my-instance-098765432109-api.us-central1.sourcemanager.dev",
       "gitHttp": "my-instance-098765432109-git.us-central1.sourcemanager.dev"
     }
   }
   }
   

   Aquí:

   • my-instance-098765432109.us-central1.sourcemanager.dev es la URL HTML de la instancia.
   • PROJECT_ID es el ID del proyecto.
   Nota: Es posible que la verificación de estado informe que se completó antes de que la instancia esté en pleno funcionamiento. Si tienes problemas para acceder a la instancia después de la creación, espera 60 minutos y vuelve a intentarlo antes de comunicarte con el equipo de asistencia de Secure Source Manager a [e-mail].

4. Copia la URL HTML del comando de verificación de estado creado correctamente. Necesitarás esta URL para acceder a la instancia con un navegador web.

Accede a una instancia

Una vez que se crea la instancia, puedes acceder a ella a través de su interfaz web con un navegador.

Nota: Para crear repositorios en la instancia, necesitas el rol de creador de repositorios (roles/securesourcemanager.repoCreator) en el proyecto de la instancia y el rol de creador de repositorios de instancias (roles/securesourcemanager.instanceRepositoryCreator) en la instancia de Secure Source Manager.

1. Para obtener la URL HTML de tu instancia, vuelve a ejecutar el siguiente comando:

      gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

2. Copia la URL HTML de la respuesta correcta del comando gcloud source-manager operations describe en la barra de direcciones de tu navegador.

3. Aparecerá una pantalla de Oauth 2.0 en la que se te preguntará si deseas otorgar sourcemanager.dev acceso a tu Google Cloud cuenta de.

4. Haz clic en el botón Permitir.

5. Se abrirá la interfaz web de Secure Source Manager. Puedes crear y ver repositorios, y todos los problemas y solicitudes de extracción asociados desde la interfaz web.

Limpia

Para evitar que se apliquen cargos a tu Google Cloud cuenta de por los recursos que usaste en esta página, borra el Google Cloud proyecto de que tiene los recursos.

Precaución: Borrar un proyecto tiene estas consecuencias:

• Se borra todo su contenido. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los ID de proyecto personalizados. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto, en lugar de todo el proyecto.

Si planeas explorar varios instructivos, arquitecturas o guías de inicio rápido, reutilizar proyectos puede ser útil para no exceder los límites de cuota de los proyectos.

1. En la Google Cloud consola, ve a la página Administrar recursos.

   Ir a Administrar recursos

2. En la lista de proyectos, elige el proyecto que deseas borrar y haz clic en Borrar.
3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrarlo.

¿Qué sigue?

• Crea y clona un repositorio
• Otorga a los usuarios acceso a la instancia
• Agrega usuarios al repositorio