Visão geral da API Storage

A API Storage de objetos usa recursos personalizados do Kubernetes e depende do modelo de recursos do Kubernetes. As APIs são usadas para o provisionamento e a administração de recursos de armazenamento de objetos. Elas são usadas para gerenciar o ciclo de vida dos recursos de armazenamento de objetos em uma determinada organização, incluindo a criação, leitura, atualização e exclusão de buckets. As APIs também são usadas para listar buckets, definir políticas de retenção de buckets e definir a classe de armazenamento de buckets. O armazenamento em blocos é gerenciado com APIs padrão do Kubernetes.

Endpoint de serviço e documento de descoberta

As APIs do KRM de armazenamento são fornecidas em três pacotes, dependendo da implantação zonal ou global.

Os endpoints de API para as APIs de armazenamento zonal e global são os seguintes, respectivamente:

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/object.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/object.global.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/storage.global.gdc.goog/v1

A variável MANAGEMENT_API_SERVER_ENDPOINT é o endpoint do servidor da API Management.

Usando o comando kubectl proxy, é possível acessar esse URL no navegador ou com uma ferramenta como curl para receber o documento de descoberta da API Storage de objetos. O comando kubectl proxy abre um proxy para o servidor da API Kubernetes na máquina local. Depois que esse comando estiver em execução, você poderá acessar o documento nos seguintes URLs:

  • http://127.0.0.1:8001/apis/object.gdc.goog/v1
  • http://127.0.0.1:8001/apis/object.global.gdc.goog/v1
  • http://127.0.0.1:8001/apis/storage.global.gdc.goog/v1

Visão geral da API REST S3

A API XML do Object Storage isolado do Google Distributed Cloud (GDC) é uma interface RESTful que permite gerenciar dados de armazenamento de objetos de maneira programática. Como uma API RESTful, ela depende de informações de método e escopo para definir as operações a serem realizadas:

  • Informações do método. Você especifica as informações do método com métodos HTTP padrão, como DELETE, GET, HEAD e PUT.
  • Informações de escopo. Você especifica as informações de escopo com um endpoint acessível (URI) e vários parâmetros de escopo. Para a API XML, os principais parâmetros de escopo são os nomes do bucket e do objeto. Para definir ainda mais o escopo das operações, use cabeçalhos HTTP e parâmetros de string de consulta.

Visão geral da API Storage de Volume

Para criar volumes permanentes, siga as etapas descritas na documentação do Kubernetes em https://kubernetes.io/docs/concepts/storage/persistent-volumes/. A interação com o Volume Storage no GDC ocorre totalmente por primitivos de armazenamento do Kubernetes. O driver do Volume Storage implementa o protocolo da Interface de Armazenamento de Contêiner (CSI, na sigla em inglês) e provisiona e orquestra os volumes no sistema de armazenamento, opaco para o usuário final do volume permanente.

O GDC oferece suporte a uma única classe de armazenamento do tipo standard-rwo. Consulte https://kubernetes.io/docs/concepts/storage/storage-classes/ para mais informações sobre classes de armazenamento.