Configurazione della CLI di Amazon ECS - Amazon Elastic Container Service

Se forniamo una traduzione della versione in lingua inglese della guida, la versione in lingua inglese della guida prevarrà in caso di conflitto. La traduzione è fornita utilizzando la traduzione automatica.

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. Impostare un profilo CLI con il seguente comando, sostituendo nome_profilo con il nome del profilo desiderato, $AWS_ACCESS_KEY_ID e $AWS_SECRET_ACCESS_KEY variabili ambientali con il AWS credenziali.

    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 seguente comando, sostituendo tipo_lancio con il tipo di lancio attività che si desidera utilizzare per impostazione predefinita, nome_regione con il vostro AWS regione, nome_cluster con il nome di un Amazon ECS cluster o un nuovo cluster da utilizzare, e configuration_name per il nome che vorresti 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 di Amazon 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 configurazione della ECS per recuperare la regione dal profilo ECS predefinito.

  3. Tentativi della variabile 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).