En esta página se explica cómo instalar y configurar la CLI de gdcloud para gestionar el almacenamiento de objetos al trabajar con proyectos de Google Distributed Cloud (GDC) aislados. Se explica cómo descargar, instalar y configurar los componentes y ajustes necesarios para usar de forma eficaz los segmentos y objetos de almacenamiento en este entorno aislado.
Esta página está dirigida a audiencias como administradores de TI del grupo de operadores de infraestructura o desarrolladores del grupo de operadores de aplicaciones que quieran aprovisionar y gestionar segmentos de almacenamiento de objetos para proyectos en entornos aislados de GDC. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.
Antes de empezar
Para instalar y configurar la CLI de almacenamiento, ponte en contacto con el admin. de la org. de gestión de identidades y accesos (IAM) para solicitar el rol de administrador de políticas de red de la organización (org-network-policy-admin), que te permite crear, editar y eliminar políticas de red de la organización.
Descargar la CLI gdcloud
Descarga y extrae un archivo de paquete de la CLI gdcloud siguiendo las instrucciones de Descargar la CLI gdcloud.
No uses un binario independiente de la CLI gdcloud que no incluya el directorio bin/component_bundles/.
Instalar la CLI gdcloud
Para usar el grupo de comandos gdcloud storage, instala el componente storage-cli-dependencies desde un paquete de la CLI gdcloud extraído:
Sigue las instrucciones de la sección Instalar la CLI gdcloud para añadir el directorio
bindel paquete extraído a tuPATH.Para instalar el componente
storage-cli-dependencies, ejecuta el siguiente comando:gdcloud components install storage-cli-dependenciesEste comando instala
storage-cli-dependenciesdesde el directoriobin/component_bundles/del paquete de la CLI gdcloud extraído. Si ejecutas este comando desde un binario independiente de la CLI gdcloud que no tienebin/component_bundles/, el comando fallará con un errorcomponent_registry.yaml: no such file or directory. Para solucionar este error, descarga y extrae un paquete de Descargar la CLI de gdcloud y ejecutabin/gdclouddesde el directorio del paquete extraído.Para obtener más información sobre el comando
components install, consulta Instalar componentes.
Configurar la CLI gdcloud para el almacenamiento de objetos
Para usar la CLI gdcloud para el almacenamiento de objetos, se deben definir las siguientes configuraciones.
Sustituye
ACCESS_KEY_IDpor el ID de clave de acceso obtenido del secreto en Obtener credenciales de acceso:gdcloud config set storage/s3_access_key_id ACCESS_KEY_IDSustituye
SECRET_ACCESS_KEYpor la clave secreta obtenida del secreto en Obtener credenciales de acceso:gdcloud config set storage/s3_secret_access_key SECRET_ACCESS_KEYSustituye
CA_BUNDLE_FILEpor la ruta del certificado AC. Se trata de un certificado digital que pertenece a una autoridad de certificación (AC), una organización de confianza que avala las identidades. Puedes solicitar el paquete de confianza de la AC de GDC a un miembro de tu grupo de operadores de infraestructura (IO). Para obtener más información sobre cómo obtener certificados de AC de GDC, consulta Obtener paquetes de confianza de GDC.gdcloud config set storage/s3_custom_ca_certs_file CA_BUNDLE_FILESustituye
ENDPOINTpor el endpoint que te proporcione tu operador de infraestructura (IO):gdcloud config set storage/s3_endpoint ENDPOINTEste paso es ligeramente diferente para los segmentos de doble zona. Cada segmento de doble región proporciona tres endpoints que puedes elegir para acceder al segmento. En la mayoría de los casos, el endpoint global es el adecuado para aprovechar las conmutaciones por error automáticas:
- Punto final de la zona 1: este punto final siempre se recibe en la zona 1. Si usas este endpoint, tendrás coherencia de lectura después de escritura para cualquier objeto escrito en zone1. Sin embargo, si la zona 1 deja de funcionar, el cliente debe cambiar al endpoint de la zona 2 o al global para seguir leyendo o escribiendo en este segmento. Si el cliente procede de un clúster de usuarios, solo se podrá acceder a este endpoint desde la zona 1.
- Endpoint de la zona 2: este endpoint siempre lo recibe la zona 2. Si usas este endpoint, tendrás coherencia de lectura después de escritura para los objetos escritos en zone2. Sin embargo, si la zona 2 deja de funcionar, el cliente debe cambiar al endpoint de la zona 1 o al global para seguir leyendo o escribiendo en este segmento. Si el cliente procede de un clúster de usuarios, solo se podrá acceder a este endpoint desde la zona 2.
- Endpoint global: este endpoint hace que tu solicitud se dirija a la zona 1 o a la zona 2. Esta opción no proporciona afinidad de sesión, lo que significa que las solicitudes realizadas con la misma sesión pueden llegar a la zona 1 o a la zona 2. Esto significa que no hay garantía de lectura después de escritura para las solicitudes realizadas al endpoint global. El endpoint global ofrece una conmutación por error automática en caso de que una zona deje de funcionar, por lo que los usuarios no tendrán que cambiar los endpoints de sus cargas de trabajo como tendrían que hacer si usaran el endpoint de zona. Además, se puede acceder a este endpoint desde clústeres de usuarios de todas las zonas.
Ejecuta los siguientes comandos en el servidor de la API de gestión para ver los endpoints globales y de zona de tu segmento y elige el que quieras usar:
kubectl get buckets BUCKET_NAME -n PROJECT_NAME -o jsonpath="{.status.globalEndpoint}" --kubeconfig MANAGEMENT_API_SERVER kubectl get buckets BUCKET_NAME -n PROJECT_NAME -o jsonpath="{.status.zonalEndpoints}" --kubeconfig MANAGEMENT_API_SERVER