Repetir a estratégia de manipulação

Repetir estratégia

As operações da gsutil podem falhar por vários motivos. Algumas não podem ser repetidas e exigem que o usuário tome alguma providência. Por exemplo:

  • Credenciais inválidas
  • Rede inacessível devido a um problema de configuração de proxy.
  • Acesso negado, porque o bucket ou objeto que você está tentando usar tem uma ACL que não permite a ação que você está tentando executar.
  • Operações individuais que falham em um comando que executa operações em paralelo (ou seja, comandos que usam a sinalização -m de nível superior).

Em outros casos, os erros podem ser repetidos — falhas temporárias na rede; códigos de erro HTTP 429 e 5xx; e códigos de erro HTTP 408 ao realizar um upload recuperável. Para esses casos, o gsutil tentará novamente usando uma estratégia de espera exponencial binária truncada:

  • Aguarde um período aleatório entre [0..1] segundos e tente novamente;
  • Se isso falhar, aguarde um período aleatório entre [0..2] segundos e tente novamente.
  • Se isso falhar, aguarde um período aleatório entre [0..4] segundos e tente novamente;
  • E assim por diante, até um número máximo configurável de novas tentativas (padrão = 23),

com cada período de repetição limitado por um período máximo configurável (padrão = 60 segundos).

Assim, por padrão, a gsutil tentará novamente 23 vezes mais de 1+2+4+8+16+32... segundos por cerca de 10 minutos. É possível ajustar o número de tentativas e o atraso máximo de qualquer tentativa individual editando as variáveis de configuração num_retries e max_retry_delay na seção "[Boto]" do arquivo de configuração .boto. A maioria dos usuários não precisará alterar esses valores.

Para transferências de dados (os comandos gsutil cp e rsync), a gsutil fornece funcionalidade de repetição adicional, na forma de transferências recuperáveis. Basicamente, uma transferência que foi interrompida por causa de um erro transitório pode ser reiniciada sem começar do zero. Para mais detalhes sobre isso, consulte a seção "TRANSFERÊNCIA RESGATÁVEL" do gsutil help cp.