Nozioni di base sul AWS CLI

Aggiungi il repository AWS Proton Sample CloudFormation Templates al tuo GitHub account o alla tua organizzazione. Questo repository include i modelli di ambiente e servizio che utilizziamo in questo tutorial.

Quindi, registra il tuo repository biforcato con. AWS Proton Per ulteriori informazioni, consulta Crea un link al tuo repository.

Crea un modello di ambiente.

La risorsa del modello di ambiente tiene traccia delle versioni del modello di ambiente.

$ aws proton create-environment-template \
  --name "fargate-env" \
  --display-name "Public VPC Fargate" \
  --description "VPC with public access and ECS cluster"

Crea una configurazione di sincronizzazione del modello.

AWS Proton imposta una relazione di sincronizzazione tra il repository e il modello di ambiente. Quindi crea la versione 1.0 del modello nello DRAFT stato.

$ aws proton create-template-sync-config \
  --template-name "fargate-env" \
  --template-type "ENVIRONMENT" \
  --repository-name "your-forked-repo" \
  --repository-provider "GITHUB" \
  --branch "your-branch" \
  --subdirectory "environment-templates/fargate-env"

Attendi che la versione del modello di ambiente venga registrata correttamente.

Quando questo comando ritorna con lo stato di uscita0, la registrazione della versione è completa. Ciò è utile negli script per garantire la corretta esecuzione del comando nel passaggio successivo.

$ aws proton wait environment-template-version-registered \
  --template-name "fargate-env" \
  --major-version "1" \
  --minor-version "0"

Pubblica la versione del modello di ambiente per renderla disponibile per la creazione dell'ambiente.

$ aws proton update-environment-template-version \
  --template-name "fargate-env" \
  --major-version "1" \
  --minor-version "0" \
  --status "PUBLISHED"

Creare un modello di servizio.

La risorsa del modello di servizio tiene traccia delle versioni del modello di servizio.

$ aws proton create-service-template \
  --name "load-balanced-fargate-svc" \
  --display-name "Load balanced Fargate service" \
  --description "Fargate service with an application load balancer"

Crea una configurazione di sincronizzazione del modello.

AWS Proton imposta una relazione di sincronizzazione tra il tuo repository e il tuo modello di servizio. Quindi crea la versione 1.0 del modello nello DRAFT stato.

$ aws proton create-template-sync-config \
  --template-name "load-balanced-fargate-svc" \
  --template-type "SERVICE" \
  --repository-name "your-forked-repo" \
  --repository-provider "GITHUB" \
  --branch "your-branch" \
  --subdirectory "service-templates/load-balanced-fargate-svc"

Attendi che la versione del modello di servizio venga registrata correttamente.

Quando questo comando restituisce lo stato di uscita0, la registrazione della versione è completa. Ciò è utile negli script per garantire la corretta esecuzione del comando nel passaggio successivo.

$ aws proton wait service-template-version-registered \
  --template-name "load-balanced-fargate-svc" \
  --major-version "1" \
  --minor-version "0"

Pubblica la versione del modello di servizio per renderla disponibile per la creazione del servizio.

$ aws proton update-service-template-version \
  --template-name "load-balanced-fargate-svc" \
  --major-version "1" \
  --minor-version "0" \
  --status "PUBLISHED"

Ottieni un file di specifiche di esempio per il modello di ambiente che hai registrato.

Puoi scaricare il file environment-templates/fargate-env/spec/spec.yaml dal repository di esempio del modello. In alternativa, puoi recuperare l'intero repository localmente ed eseguire il create-environment comando dalla directory. environment-templates/fargate-env

Crea un ambiente.

AWS Proton legge i valori di input dalle specifiche di ambiente, li combina con il modello di ambiente ed effettua il provisioning delle risorse di ambiente nel tuo AWS account utilizzando il tuo ruolo di servizio. AWS Proton

$ aws proton create-environment \
  --name "fargate-env-prod" \
  --template-name "fargate-env" \
  --template-major-version 1 \
  --proton-service-role-arn "arn:aws:iam::123456789012:role/AWS ProtonServiceRole" \
  --spec "file://spec/spec.yaml"

Attendi che l'ambiente venga implementato correttamente.

$ aws proton wait environment-deployed --name "fargate-env-prod"

Ottieni un file di specifiche di esempio per il modello di servizio registrato dall'amministratore.

È possibile scaricare il file service-templates/load-balanced-fargate-svc/spec/spec.yaml dal repository di esempio dei modelli. In alternativa, puoi recuperare l'intero repository localmente ed eseguire il create-service comando dalla directory. service-templates/load-balanced-fargate-svc

Aggiungi il repository AWS Proton Sample Services al tuo GitHub account o alla tua organizzazione. Questo repository include il codice sorgente dell'applicazione che utilizziamo in questo tutorial.

Crea un servizio.

AWS Proton legge i valori di input dalle specifiche del servizio, li combina con il modello di servizio ed effettua il provisioning delle risorse di servizio nel tuo AWS account nell'ambiente specificato nella specifica. Una AWS CodePipeline pipeline distribuisce il codice dell'applicazione dal repository specificato nel comando.

$ aws proton create-service \
  --name "static-website" \
  --repository-connection-arn \
    "arn:aws:codestar-connections:us-east-1:123456789012:connection/your-codestar-connection-id" \
  --repository-id "your-GitHub-account/aws-proton-sample-services" \
  --branch-name "main" \
  --template-major-version 1 \
  --template-name "load-balanced-fargate-svc" \
  --spec "file://spec/spec.yaml"

Attendi che il servizio venga distribuito correttamente.

$ aws proton wait service-created --name "static-website"

Recupera i risultati e visualizza il tuo nuovo sito web.

Esegui il comando seguente:

$ aws proton list-service-instance-outputs \
  --service-name "static-website" \
  --service-instance-name load-balanced-fargate-svc-prod

L'output del comando dovrebbe essere simile al seguente:

{
    "outputs": [
        {
            "key": "ServiceURL",
            "valueString": "http://your-service-endpoint.us-east-1.elb.amazonaws.com"
        }
    ]
}

Il valore dell'output dell'ServiceURListanza è l'endpoint del nuovo sito Web di servizio. Usa il tuo browser per accedervi. Dovresti vedere il seguente grafico su una pagina statica:

Per eliminare il servizio, esegui il comando seguente:

$ aws proton delete-service --name "static-website"

Per eliminare l'ambiente, esegui il comando seguente:

$ aws proton delete-environment --name "fargate-env-prod"

Per eliminare il modello di servizio, esegui i seguenti comandi:

$ aws proton delete-template-sync-config \
  --template-name "load-balanced-fargate-svc" \
  --template-type "SERVICE"
$ aws proton delete-service-template --name "load-balanced-fargate-svc"

Per eliminare il modello di ambiente, esegui i seguenti comandi:

$ aws proton delete-template-sync-config \
  --template-name "fargate-env" \
  --template-type "ENVIRONMENT"
$ aws proton delete-environment-template --name "fargate-env"