Los proyectos de dispositivos aislados de Google Distributed Cloud (GDC) forman la base para crear, habilitar y usar todos los servicios de GDC, incluida la administración de APIs, la adición y eliminación de colaboradores, y la administración de permisos para los recursos de GDC.
En esta página, se explica cómo administrar proyectos de GDC con la consola de GDC, la CLI de gdcloud y la CLI de kubectl.
Antes de comenzar
Antes de ver o administrar proyectos y sus recursos, debes solicitar los permisos necesarios y preparar tu entorno.
Solicita roles de IAM
Comunícate con el administrador de IAM de tu organización para solicitar los siguientes roles según las tareas que debas realizar:
- Editor del proyecto (
project-editor): Actualiza, visualiza y borra un proyecto existente y sus recursos. - Visualizador del proyecto (
project-viewer): Visualiza un proyecto existente y sus recursos.
Prepara el entorno
Descarga y, luego, instala la CLI de gdcloud si aún no lo hiciste.
Instala la CLI de
kubectl, como se describe en Instala componentes.Genera un archivo kubeconfig para configurar el acceso a
kubectl.
Ver detalles del proyecto
Puedes ver los metadatos de tu proyecto para revisar la configuración actual, como las etiquetas y la configuración de red.
Console
Abre el menú de navegación y selecciona Proyectos.
Haz clic en el proyecto cuyos detalles deseas ver:
gdcloud
Para enumerar los metadatos de un proyecto específico, ejecuta el siguiente comando:
gdcloud projects describe PROJECT_ID
Reemplaza PROJECT_ID por el identificador único de tu proyecto.
Verifica los recursos del proyecto
Puedes verificar los recursos del proyecto para supervisar la segmentación de los recursos dentro de una organización. También puedes consultar las políticas de acceso de usuarios y grupos, que defines por proyecto para establecer límites entre ellos.
Enumera las vinculaciones de roles en un proyecto
Para enumerar las vinculaciones de roles en un proyecto, ejecuta el siguiente comando:
kubectl get rolebindings -n PROJECT_NAMESPACE
Para obtener más información sobre las vinculaciones de roles, consulta Otorga acceso a los recursos.
Selecciona un proyecto o una organización
En la consola de GDC, puedes seleccionar un proyecto o una organización con el selector de proyectos para interactuar con los recursos de servicio anidados en ese recurso principal. Por ejemplo, una máquina virtual (VM) tiene alcance a nivel del proyecto.
El selector de proyectos realiza la transición automáticamente entre los tipos de recursos principales más recientes cuando cambia el contexto del recurso secundario. Por ejemplo, cuando accedes a un recurso con alcance de proyecto y tienes seleccionada una organización, el selector elige automáticamente el último proyecto utilizado para cambiar sin problemas el alcance del recurso. Del mismo modo, la organización se selecciona automáticamente cuando se accede a los recursos con alcance de la organización.
Para interactuar con los recursos de GDC anidados en un recurso principal, primero debes seleccionar la organización o el proyecto en el que trabajarás:
En el panel, haz clic en el menú desplegable del selector de proyectos.
En la ventana Proyectos que aparece, selecciona tu proyecto u organización.
Haz clic en Abrir.
Actualiza un proyecto
Hay un subconjunto de configuraciones de tu proyecto que se pueden actualizar después de la creación, como el nombre del proyecto y la protección robo de datos. Puedes actualizar estos parámetros de configuración a medida que evoluciona tu uso del proyecto.
Por ejemplo, puedes editar el nombre del proyecto siguiendo estos pasos:
Console
Abre el menú de navegación y selecciona Proyectos.
Haz clic en el proyecto que quieras editar.
Haz clic en editar Editar junto al campo Nombre visible del proyecto.
Proporciona el nombre del proyecto actualizado y haz clic en Guardar.
gdcloud
Ejecuta el comando siguiente:
gdcloud projects update PROJECT_ID --name=PROJECT_NAME
Reemplaza las siguientes variables:
PROJECT_ID: Es el identificador único de tu proyecto.PROJECT_NAME: Es el nombre nuevo del proyecto.
Puedes reemplazar el parámetro --name por cualquier campo del proyecto que se pueda editar. Ejecuta gdcloud projects update --help para ver más opciones.
Cómo ver proyectos en una organización
Como administrador, solo puedes ver y enumerar los proyectos a los que tienes acceso con los roles de IAM. El rol Administrador de IAM de la organización puede ver y enumerar todos los proyectos de la organización.
Console
Para ver todos los proyectos de una organización, ve al menú de navegación de la consola y selecciona Proyectos.
gdcloud
Para ver todos los proyectos a los que tienes acceso en una organización, ejecuta el siguiente comando:
gdcloud projects list
No puedes enumerar los proyectos a los que no tienes permiso de acceso.