Nesta página, mostramos como fazer upload e download de objetos para e de buckets de armazenamento de appliance isolado do Google Distributed Cloud (GDC, na sigla em inglês).
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 objetos
Use as diretrizes a seguir para nomear objetos:
- Use caracteres UTF-8 ao nomear objetos.
- Não inclua informações de identificação pessoal (PII).
Fazer upload de objetos para buckets de armazenamento
Para fazer upload de um objeto, execute os comandos a seguir:
gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
gdcloud storage mv s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
O comando a seguir faz o upload de todos os arquivos de texto do diretório local para um bucket:
gdcloud storage cp *.txt s3://BUCKET
O comando a seguir faz o upload de vários arquivos do diretório local para um bucket:
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
Para fazer upload de uma pasta para um bucket, use a opção --recursive para copiar uma árvore de diretórios inteira. O comando a seguir faz o upload da árvore de diretórios dir:
gdcloud storage cp dir s3://BUCKET --recursive
Realize uploads de várias partes para objetos grandes ou use uploads de várias partes automaticamente quando tiver um arquivo maior que 15 MB para fazer upload. Nesse caso, o arquivo é dividido em várias partes, com cada parte de 15 MB. A última parte é menor. Cada parte é enviada separadamente e reconstruída no destino quando a transferência é concluída.
Se o upload de uma parte falhar, você poderá reiniciar o upload sem afetar nenhuma das outras partes já enviadas.
Há duas opções relacionadas a uploads de várias partes:
--disable-multipart: desativa uploads de várias partes para todos os arquivos.--multipart-chunk-size-mb=SIZE: define o tamanho de cada parte de um upload de várias partes.
Arquivos maiores que SIZE são enviados automaticamente como várias partes multithread. Arquivos menores são enviados usando o método tradicional. SIZE está em megabytes. O tamanho padrão da parte é 15 MB. O tamanho mínimo permitido da parte é 5 MB e o máximo é 5 GB.
Fazer o download de objetos de buckets de armazenamento
Para receber objetos do bucket:
gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE
Para fazer o download de todos os arquivos de texto de um bucket para o diretório atual:
gdcloud storage cp s3://BUCKET/*.txt .
Para fazer o download do arquivo de texto abc.txt de um bucket para o diretório atual:
gdcloud storage cp s3://BUCKET/abc.txt .
Para fazer o download de uma versão mais antiga do arquivo, liste todas as versões do arquivo primeiro:
gdcloud storage ls s3://BUCKET/abc.txt --all-versions
Exemplo de saída:
s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3
Em seguida, faça o download de uma versão específica do arquivo de texto abc.txt do bucket para o diretório atual:
gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .