Configurazione della CLI di Amazon ECS - Amazon Elastic Container Service

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 della CLI di Amazon ECS

Prima di poterla utilizzare, la CLI di Amazon ECS richiede alcune informazioni di base per la configurazione, ad esempio le credenziali AWS, la regione AWS in cui creare il cluster e il nome del cluster Amazon ECS da utilizzare. Le informazioni di configurazione vengono memorizzate nella directory ~/.ecs sui sistemi macOS e Linux e in C:\Users\<username>\AppData\local\ecs sui sistemi Windows.

Per configurare la CLI di Amazon ECS

  1. Configurazione di un profilo CLI con il comando seguente, sostituendo nome_profilo con il nome del profilo desiderato, le variabili di ambiente $AWS_ACCESS_KEY_ID e $AWS_SECRET_ACCESS_KEY con le credenziali AWS.

    ecs-cli configure profile --profile-name profile_name --access-key $AWS_ACCESS_KEY_ID --secret-key $AWS_SECRET_ACCESS_KEY
  2. Completare la configurazione con il comando seguente, sostituendo tipo_avvio con il tipo di lancio dell'attività che si desidera utilizzare per impostazione predefinita, nome_regione con la regione AWS desiderata, nome_cluster con il nome di un cluster Amazon ECS esistente o nuovo da utilizzare e configuration_name per il nome che desideri assegnare a questa configurazione.

    ecs-cli configure --cluster cluster_name --default-launch-type launch_type --region region_name --config-name configuration_name

Dopo aver installato e configurato la CLI, puoi provare il Tutorial: Creazione di un cluster con un'attività Fargate utilizzando la CLI diAmazon ECS. Per ulteriori informazioni, consulta la Guida di riferimento alla riga di comando di Amazon ECS nella Amazon Elastic Container Service Developer Guide.

Profiles

La CLI di Amazon ECS supporta la configurazione di più set di credenziali AWS come profili con nome, tramite il comando ecs-cli configure profile. Puoi configurare un profilo predefinito tramite il comando ecs-cli configure profile default. Quando esegui nella CLI di Amazon ECS comandi che richiedono credenziali, puoi fare riferimento a tali profili tramite il contrassegno --ecs-profile; altrimenti, viene utilizzato il profilo predefinito.

Per ulteriori informazioni, consulta la Guida di riferimento alla riga di comando di Amazon ECS nella Amazon Elastic Container Service Developer Guide.

Configurazioni cluster

Una configurazione cluster è un insieme di campi che descrive un cluster Amazon ECS con valori quali il nome del cluster e la regione. Puoi impostare una configurazione cluster predefinita tramite il comando ecs-cli configure default. Tramite l'opzione --config-name, la CLI di Amazon ECS supporta la definizione di più configurazioni cluster con nome.

Per ulteriori informazioni, consulta la Guida di riferimento alla riga di comando di Amazon ECS nella Amazon Elastic Container Service Developer Guide.

Ordine di precedenza

Sono disponibili più modi per trasmettere credenziali e regione insieme in un comando della CLI di Amazon ECS. Di seguito è riportato l'ordine di precedenza per ciascuno di essi.

L'ordine di precedenza per le credenziali è:

  1. Contrassegno del profilo della CLI di Amazon ECS:

    1. Profilo ECS (--ecs-profile)

    2. Profilo AWS (--aws-profile)

  2. Variabili di ambiente:

    1. ECS_PROFILE

    2. AWS_PROFILE

    3. AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY e AWS_SESSION_TOKEN

  3. Tentativi della configurazione ECS‐di recuperare le credenziali dal profilo ECS predefinito.

  4. Tentativi del profilo AWS predefinito—di utilizzare le credenziali (aws_access_key_id, aws_secret_access_key) o assume_role (role_arn, source_profile) dal nome del profilo AWS.

    1. Variabile di ambiente AWS_DEFAULT_PROFILE (con impostazione predefinita su default).

  5. Ruolo dell'istanza EC2

L'ordine di precedenza per la regione è:

  1. Contrassegno della CLI di Amazon ECS:

    1. Contrassegno della regione (--region)

    2. Contrassegno di configurazione del cluster (--cluster-config)

  2. Tentativi‐di config ECS di recuperare la regione dal profilo ECS predefinito.

  3. Tentativi—variabili di ambiente di recuperare la regione dalle seguenti variabili di ambiente:

    1. AWS_REGION

    2. AWS_DEFAULT_REGION

  4. Tentativi del profilo AWS di utilizzare la regione dal nome del profilo ‐:AWS

    1. Variabile di ambiente AWS_PROFILE

    2. Variabile di ambiente AWS_DEFAULT_PROFILE (con impostazione predefinita su default)