Configurazione esterna dell' AWS SDK per i client del servizio Ruby - AWS SDK per Ruby

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione esterna dell' AWS SDK per i client del servizio Ruby

Molte impostazioni di configurazione possono essere gestite al di fuori del codice. Quando la configurazione viene gestita esternamente, viene applicata a tutte le applicazioni. La maggior parte delle impostazioni di configurazione può essere impostata come variabili di ambiente o in un file condiviso separato. AWS config Il config file condiviso può mantenere set di impostazioni separati, chiamati profili, per fornire configurazioni diverse per ambienti o test diversi.

Le variabili di ambiente e le impostazioni dei config file condivisi sono standardizzate e condivise tra AWS SDKs strumenti per supportare funzionalità coerenti tra diversi linguaggi di programmazione e applicazioni.

Consulta la AWS SDKs and Tools Reference Guide per ulteriori informazioni sulla configurazione dell'applicazione con questi metodi, oltre a dettagli su ciascuna impostazione cross-sdk. Per visualizzare tutte le impostazioni che l'SDK è in grado di risolvere a partire dalle variabili di ambiente o dai file di configurazione, consulta il riferimento alle impostazioni nella Guida di riferimento agli strumenti AWS SDKs e agli strumenti.

Per effettuare una richiesta a un Servizio AWS, devi prima creare un'istanza di un client per quel servizio. È possibile configurare impostazioni comuni per i client di servizio, ad esempio i timeout, il client HTTP e riprovare la configurazione.

Ogni client di servizio richiede un fornitore di credenziali Regione AWS e un provider di credenziali. L'SDK utilizza questi valori per inviare le richieste alla regione corretta per le tue risorse e per firmare le richieste con le credenziali corrette. Puoi specificare questi valori a livello di codice a livello di codice o caricarli automaticamente dall'ambiente.

L'SDK ha una serie di posizioni (o fonti) che controlla per trovare un valore per le impostazioni di configurazione.

  1. Qualsiasi impostazione esplicita impostata nel codice o su un client di servizio stesso ha la precedenza su qualsiasi altra cosa.

  2. Variabili di ambiente

    • Per i dettagli sull'impostazione delle variabili di ambiente, consultate le variabili di ambiente nella Guida di riferimento agli strumenti AWS SDKs e agli strumenti.

    • Nota che puoi configurare le variabili di ambiente per una shell a diversi livelli di ambito: a livello di sistema, a livello di utente e per una sessione di terminale specifica.

  3. Condivisi e file config credentials

  4. Qualsiasi valore predefinito fornito dal codice sorgente SDK stesso viene utilizzato per ultimo.

    • Alcune proprietà, come Region, non hanno un valore predefinito. È necessario specificarle esplicitamente nel codice, in un'impostazione di ambiente o nel config file condiviso. Se l'SDK non è in grado di risolvere la configurazione richiesta, le richieste API possono avere esito negativo in fase di esecuzione.

AWS SDK per variabili di ambiente Ruby

Oltre alle variabili di ambiente cross-sdk supportate dalla maggior parte AWS SDKs, l' AWS SDK for Ruby ne supporta alcune uniche:

AWS_SDK_CONFIG_OPT_OUT

Se la variabile di AWS_SDK_CONFIG_OPT_OUT ambiente AWS SDK for Ruby è impostata, AWS config il file condiviso, in ~/.aws/config genere at, non verrà utilizzato per alcun valore di configurazione.

AMAZON_REGION

Una variabile di ambiente alternativa a quella AWS_REGION per l'impostazione di. Regione AWS Questo valore viene controllato solo se non AWS_REGION viene utilizzato.