Configurar clientes de serviço do AWS SDK para Ruby externamente - AWS SDK para Ruby
Variáveis ​​de ambiente do AWS SDK para Ruby.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar clientes de serviço do AWS SDK para Ruby externamente

Muitas configurações podem ser tratadas fora do código. Quando a configuração é tratada externamente, ela é aplicada a todas as suas aplicações. A maioria das configurações pode ser definida como variáveis de ambiente ou em um arquivo AWS config compartilhado distinto. O arquivo config compartilhado pode manter conjuntos separados de configurações, chamados de perfis, para fornecer configurações diferentes para ambientes ou testes distintos.

As configurações de variáveis de ambiente e do arquivo config compartilhado são padronizadas e compartilhadas entre os SDKs e ferramentas da AWS para comportar a funcionalidade consistente em diferentes linguagens de programação e aplicações.

Consulte o Guia de referência de ferramentas e AWS SDKs para saber como configurar a aplicação por meio desses métodos, além de detalhes sobre cada configuração entre SDKs. Consulte todas as configurações que podem ser tratadas pelo SDK com base nas variáveis de ambiente ou nos arquivos de configuração na Referência de configurações no Guia de referência de ferramentas e AWS SDKs.

Para fazer uma solicitação a um AWS service (Serviço da AWS), primeiro você instancia um cliente para esse serviço. Você pode definir configurações comuns para clientes de serviço, como tempos limite, o cliente HTTP e configuração de repetição.

Cada cliente de serviço exige uma Região da AWS e um provedor de credenciais. O SDK usa esses valores para enviar solicitações à região correta para seus recursos e para assinar solicitações com as credenciais corretas. Você pode especificar esses valores de modo programático no código ou fazer com que sejam carregados automaticamente do ambiente.

O SDK tem uma série de locais (ou fontes) que ele confere para encontrar um valor para as configurações.

  1. Qualquer configuração explícita definida no código ou no próprio cliente de serviço tem precedência sobre qualquer outra coisa.

  2. Variáveis de ambiente

    • Para ver detalhes sobre a configuração de variáveis de ambiente, consulte variáveis de ambiente no Guia de referência de ferramentas e AWS SDKs.

    • Observe que você pode configurar variáveis de ambiente para um shell em diferentes níveis de escopo: em todo o sistema, para o usuário e para uma sessão de terminal específica.

  3. Arquivos config e credentials compartilhados

  4. Qualquer valor padrão fornecido pelo próprio código-fonte do SDK é usado por último.

    • Algumas propriedades, como região, não têm um padrão. Você deve especificá-las explicitamente no código, em uma configuração de ambiente ou no arquivo config compartilhado. Se o SDK não conseguir resolver a configuração exigida, as solicitações de API poderão falhar no runtime.

Variáveis ​​de ambiente do AWS SDK para Ruby.

Além das variáveis ​​de ambiente entre SDKs compatíveis na maior partes dos AWS SDKs, o AWS SDK para Ruby comporta algumas variáveis ​​exclusivas:

AWS_SDK_CONFIG_OPT_OUT

Se a variável de ambiente AWS_SDK_CONFIG_OPT_OUT do AWS SDK para Ruby estiver definida, o arquivo compartilhado config da AWS, normalmente localizado em ~/.aws/config, não será usado para nenhum valor de configuração.

AMAZON_REGION

Uma variável de ambiente alternativa para AWS_REGION para definição de Região da AWS. Esse valor só será conferido se AWS_REGION não estiver em uso.