En esta página, se explica cómo crear un bucket de almacenamiento para tus proyectos de dispositivos aislados de Google Distributed Cloud (GDC). Se abarcan los requisitos previos, los pasos de creación y verificación, y los lineamientos para la asignación de nombres. Esto te ayuda a establecer un almacenamiento de objetos compatible y bien configurado que satisfaga las necesidades de tus implementaciones aisladas.
Esta página está destinada a públicos como administradores de TI dentro del grupo de operadores de infraestructura o desarrolladores dentro del grupo de operadores de aplicaciones que desean aprovisionar y administrar buckets de almacenamiento de objetos para proyectos en entornos aislados de GDC.
Antes de comenzar
Un espacio de nombres del proyecto administra los recursos del bucket en el servidor de la API de administración. Debes tener un proyecto para trabajar con buckets y objetos.
También debes tener los permisos de bucket adecuados para realizar la siguiente operación. Consulta Cómo otorgar acceso al bucket.
Para ejecutar comandos en el servidor de la API de administración, accede y genera el archivo kubeconfig para el servidor de la API de administración si no tienes uno.
Lineamientos para asignar nombres a bucket de almacenamiento
Los nombres de los buckets deben cumplir con las siguientes convenciones de nombres:
- Deben ser únicos en el proyecto. Un proyecto agrega un prefijo único al nombre del bucket, lo que garantiza que no haya conflictos dentro de la organización. En el improbable caso de que haya un conflicto de prefijo y nombre de bucket en las organizaciones, la creación del bucket falla con un error
bucket name in use. - Deben tener al menos un carácter y no más de 57.
- No deben incluir ningún tipo de información de identificación personal (PII).
- Deben ser compatibles con DNS.
- Deben comenzar con una letra y solo pueden contener letras, números y guiones.
Crea un bucket
Para crear un bucket, aplica una especificación de bucket a tu espacio de nombres del proyecto:
kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f bucket.yaml
El siguiente es un ejemplo de una especificación de bucket:
apiVersion: object.gdc.goog/v1
kind: Bucket
metadata:
name: BUCKET_NAME
namespace: NAMESPACE_NAME
spec:
description: DESCRIPTION
storageClass: Standard
bucketPolicy:
lockingPolicy:
defaultObjectRetentionDays: RETENTION_DAY_COUNT
Para obtener más detalles, consulta la referencia de la API de Bucket.