Criar buckets de armazenamento

Esta página orienta você na criação de um bucket de armazenamento para projetos de appliance isolado do Google Distributed Cloud (GDC). Ela aborda pré-requisitos, etapas de criação e verificação e diretrizes de nomenclatura. Isso ajuda a estabelecer um armazenamento de objetos compatível e bem configurado que atenda às necessidades das implantações isoladas.

Esta página é destinada a públicos-alvo, como administradores de TI no grupo de operadores de infraestrutura ou desenvolvedores no grupo de operadores de aplicativos, que querem provisionar e gerenciar buckets de armazenamento de objetos para projetos em ambientes isolados do GDC.

Antes de começar

Um namespace de projeto gerencia recursos de bucket no servidor da API de gerenciamento. Você precisa ter um projeto para trabalhar com buckets e objetos.

Você também precisa ter as permissões de bucket adequadas para realizar a operação a seguir. Consulte Conceder acesso ao bucket.

Para executar comandos no servidor da API de gerenciamento, faça login e gere o arquivo kubeconfig para o servidor da API de gerenciamento, se você não tiver um.

Diretrizes de nomenclatura de bucket de armazenamento

Os nomes dos buckets precisam seguir as convenções de nomenclatura a seguir:

  • Ser exclusivo no projeto. Um projeto anexa um prefixo exclusivo ao nome do bucket, garantindo que não haja conflitos na organização. No caso improvável de um conflito de prefixo e nome de bucket entre organizações, a criação do bucket falha com um erro bucket name in use.
  • Ter pelo menos um e no máximo 57 caracteres.
  • Não incluir informações de identificação pessoal (PII).
  • Ser compatível com DNS.
  • Começar com uma letra e conter apenas letras, números e hífens.

Criar um bucket

Para criar um bucket, aplique uma especificação de bucket ao namespace do projeto:

  kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f bucket.yaml

Confira a seguir um exemplo de especificação 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 mais detalhes, consulte a referência da API Bucket.