Repetir a estratégia de manipulação

Repetir estratégia

Se uma operação da gsutil falhar por um dos seguintes motivos, tome medidas a antes de tentar novamente:

  • 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).

A gsutil repete os seguintes erros sem exigir que você realize outras ações:

  • Falhas de rede temporárias
  • Códigos de erro HTTP 429 e 5xx
  • Códigos de erro HTTP 408 ao fazer um upload retomável

Para erros repetíveis, a gsutil repete solicitações 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+60... 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. Na maioria das vezes, não é necessário 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.

Para saber mais sobre como outras ferramentas do Cloud Storage lidam com a estratégia de repetição de erros, consulte Estratégia de repetição.