En este documento se explica cómo crear un proyecto de Google Distributed Cloud (GDC) aislado para agrupar tus recursos dentro de una organización. Los proyectos proporcionan un límite de ciclo de vida y de políticas para los recursos, lo que permite que varios grupos de usuarios gestionen los recursos de GDC por separado.
Este documento está dirigido a audiencias como administradores de TI, ingenieros de seguridad y administradores de red del grupo de administradores de plataformas que se encargan de gestionar los recursos de su organización. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.
Antes de empezar
Para realizar las tareas de este documento, debes completar lo siguiente:
Para obtener los permisos que necesitas para crear un proyecto, pide al admin. de la org. de gestión de identidades y accesos que te conceda el rol de Creador del proyecto (
project-creator).Para usar la CLI gdcloud, asegúrate de que la tienes instalada. Para obtener más información, consulta Instalar la CLI gdcloud.
Para usar Terraform, asegúrate de que lo tienes configurado. Para obtener más información, consulta Configurar Terraform.
Crear un proyecto
Puedes crear un proyecto para agrupar lógicamente los recursos de servicio. Por ejemplo, puedes crear proyectos independientes para almacenar recursos de entornos de desarrollo, prueba y producción.
Para obtener los permisos que necesitas para crear un proyecto, pide al admin. de la org. de gestión de identidades y accesos que te conceda el rol de Creador del proyecto. Para obtener más información sobre cómo conceder permisos, consulta la sección Asignar una vinculación de rol a la identidad de servicio.
Consola
Para crear un proyecto con la consola de GDC, sigue estos pasos:
- En el menú de navegación, haz clic en Proyectos.
- Haz clic en Añadir proyecto.
- En el campo Project name (Nombre del proyecto), introduce un nombre.
- Especifica el ID de la cuenta de facturación que quieres asociar al proyecto. Para hacer un seguimiento de los costes de los recursos de un proyecto, este debe estar vinculado a una cuenta de facturación. Para obtener más información, consulta el artículo Crear y vincular cuentas de facturación.
- Haz clic en Continuar.
- Opcional: Configura las funciones de red de tu proyecto. Desmarca la casilla Habilitar protección contra la filtración de datos para inhabilitar todo el tráfico de salida a otros proyectos de tu organización.
- Haz clic en Continuar.
- En la sección Revisar, consulta el resumen y haz clic en Crear.
- Para verificar que el nuevo proyecto está disponible, se mostrará un mensaje en la consola:
Project PROJECT_NAME successfully created.
gdcloud
Para crear un proyecto con la CLI gdcloud, sigue estos pasos:
Para crear un proyecto, ejecuta lo siguiente:
gdcloud projects create PROJECT_IDSustituye
PROJECT_IDpor el identificador único de tu nuevo proyecto.Verifica que el nuevo proyecto esté disponible:
gdcloud projects listEl resultado debería ser similar al siguiente:
METADATA.NAME my-projectVincula tu nuevo proyecto con una cuenta de facturación. Para hacer un seguimiento de los costes de los recursos de un proyecto, debes tener una cuenta de facturación asociada vinculada a tu proyecto.
API
Para crear un proyecto directamente con la API, sigue estos pasos:
Define una variable de entorno para el archivo kubeconfig del servidor de la API de gestión global:
export KUBECONFIG=GLOBAL_API_SERVER_KUBECONFIGSi no tienes el archivo kubeconfig del servidor de la API de gestión global, genera uno.
Crea y aplica el recurso personalizado
Project:kubectl --kubeconfig=${KUBECONFIG} apply -f - <<EOF apiVersion: resourcemanager.global.gdc.goog/v1 kind: Project metadata: namespace: platform name: PROJECT_ID EOFSustituye
PROJECT_IDpor el identificador único de tu nuevo proyecto.Verifica que el nuevo proyecto esté disponible:
kubectl --kubeconfig=${KUBECONFIG} get projects -n platformEl resultado debería ser similar al siguiente:
NAME READY my-projectVincula tu nuevo proyecto con una cuenta de facturación. Para hacer un seguimiento de los costes de los recursos de un proyecto, debes tener una cuenta de facturación asociada vinculada a tu proyecto.
Terraform
Para crear un proyecto con Terraform, sigue estos pasos:
Asegúrate de que Terraform esté configurado y de que se hayan definido los conjuntos de permisos adecuados. Para obtener más información, consulta la página Configurar Terraform.
En un archivo de configuración de Terraform, inserta el siguiente fragmento de código:
provider "kubernetes" { config_path = "GLOBAL_API_SERVER_KUBECONFIG" }Sustituye
GLOBAL_API_SERVER_KUBECONFIGpor la ruta al archivo kubeconfig del servidor de la API de gestión global. Si no tienes este archivo kubeconfig, genera uno.En un archivo de configuración de Terraform, como
main.tf, inserta el siguiente fragmento de código:resource "kubernetes_manifest" "project-create" { manifest = { "apiVersion" = "resourcemanager.global.gdc.goog/v1" "kind" = "Project" "metadata" = { "name" = "PROJECT_ID" "namespace" = "platform" } } }Sustituye
PROJECT_IDpor el identificador único de tu nuevo proyecto.Aplica el nuevo proyecto con Terraform:
terraform applyVincula tu nuevo proyecto con una cuenta de facturación. Para hacer un seguimiento de los costes de los recursos de un proyecto, debes tener una cuenta de facturación asociada vinculada a tu proyecto.