Como usar o boto

Nesta página, você verá como a gsutil usa um arquivo de configuração boto e um exemplo de colaboração com boto.

Como usar o boto com o Cloud Storage

  • Quando a gsutil foi instalada como parte do SDK do Google Cloud:

    É recomendável instalar a gsutil como parte do SDK do Google Cloud. Dessa forma, o arquivo de configuração boto/gsutil contém valores que controlam o comportamento da gsutil, como a API preferencial dela (com a variável prefer_api). Essas variáveis podem ser alteradas editando diretamente o arquivo. O arquivo não contém credenciais e não controla o ID do projeto padrão, porque eles são gerenciados pelo SDK do Cloud.

  • Quando a gsutil foi instalada como uma ferramenta autônoma:

    Quando a gsutil é instalada como ferramenta autônoma, o arquivo de configuração boto/gsutil contém valores que controlam o comportamento da gsutil, como qual a API preferencial e o ID do projeto padrão que a gsutil usa com as variáveis prefer_api e default_project_id, respectivamente. Essas variáveis podem ser alteradas editando diretamente o arquivo. O arquivo também controla credenciais e configurações do OAuth2, normalmente criadas usando o comando gsutil config.

O local padrão do arquivo de configuração boto é o diretório inicial do usuário, ~/.boto, para Linux e macOS, e %HOMEDRIVE%%HOMEPATH%, para Windows. Para ver o local do arquivo de configuração, execute o comando gsutil version -l.

Para modificar o local em que o arquivo de configuração é usado, defina a variável de ambiente BOTO_CONFIG. Também é possível definir a variável de ambiente BOTO_PATH para configurar o caminho dos arquivos de configuração boto a serem carregados. Isso pode ser útil, por exemplo, em cenários de colaboração e compartilhamento de dados, como no exemplo abaixo.

Para uma lista completa do conteúdo do arquivo de configuração boto, consulte gsutil config.

Exemplo de colaboração com boto

Neste exemplo, uma pequena empresa quer usar o Cloud Storage como sistema de armazenamento para os funcionários. O administrador de TI cria um projeto no Console do Google Cloud Platform e cria intervalos para cada funcionário. Para facilitar o uso do Cloud Storage pelos funcionários, o administrador quer criar e armazenar as configurações para toda a empresa (como uma configuração de proxy e limites de upload composto paralelo) em um arquivo central que os funcionários possam apontar como caminho de configuração BOTO. Isso elimina a necessidade de cada funcionário definir manualmente as partes compartilhadas da configuração e permite que o administrador altere com facilidade essas configurações compartilhadas, se necessário.

Para isso, é necessário executar as seguintes etapas:

  1. Criar um arquivo central de configuração boto que seja legível para todos os funcionários.

    Isso pode ser feito usando gcloud init quando a gsutil é instalada como parte do SDK do Google Cloud.

    O arquivo de configuração boto pode conter, por exemplo:

    [Boto]
    proxy = yourproxy.com
    proxy_port = 8080
    proxy_type = http
     
    [GSUtil]
    parallel_composite_upload_threshold = 150M
    
  2. Instruir os funcionários a instalar o SDK do Google Cloud.

    Durante a instalação, os funcionários precisam especificar o ID do projeto que a empresa está usando. Eles também precisam gerar credenciais de autenticação individuais, porque não é possível compartilhar credenciais de autenticação centralmente.

  3. Instruir os funcionários a adicionar uma variável de ambiente BOTO_PATH.

    A variável de ambiente BOTO_PATH indica o caminho do arquivo de configuração localizado centralmente, seguido pelo arquivo de configuração local do funcionário. Por exemplo, se o arquivo de configuração central estiver localizado no diretório centralhub/, para o usuário jane, a variável de ambiente BOTO_PATH poderá ser:

    BOTO_PATH =/centralhub/boto.cfg:home/jane/.boto

Quando os funcionários executam a gsutil, usam automaticamente a configuração especificada no arquivo boto central. Se necessário, o administrador pode alterar as configurações de proxy, o limite de upload composto paralelo e outras definições no arquivo de configuração central e refletir essas alterações para todos os funcionários usando esse arquivo.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.