Démarrage avec le plugin AWS CLI

Intégrez le référentiel AWS Proton d'exemples CloudFormation de modèles à votre GitHub compte ou à votre organisation. Ce référentiel inclut les modèles d'environnement et de service que nous utilisons dans ce didacticiel.

Enregistrez ensuite votre référentiel bifurqué auprès AWS Proton de. Pour de plus amples informations, veuillez consulter Créez un lien vers votre référentiel.

Créez un modèle d'environnement.

La ressource de modèle d'environnement permet de suivre les versions des modèles d'environnement.

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

Créez une configuration de synchronisation des modèles.

AWS Proton définit une relation de synchronisation entre votre référentiel et votre modèle d'environnement. Il crée ensuite la version 1.0 du modèle dans DRAFT status.

$ 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"

Attendez que la version du modèle d'environnement soit correctement enregistrée.

Lorsque cette commande revient avec un état de sortie égal à0, l'enregistrement de la version est terminé. Ceci est utile dans les scripts pour vous assurer que vous pouvez exécuter correctement la commande à l'étape suivante.

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

Publiez la version du modèle d'environnement pour la rendre disponible pour la création de l'environnement.

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

Créez un modèle de service.

La ressource de modèle de service permet de suivre les versions des modèles de service.

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

Créez une configuration de synchronisation des modèles.

AWS Proton met en place une relation de synchronisation entre votre référentiel et votre modèle de service. Il crée ensuite la version 1.0 du modèle dans DRAFT status.

$ 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"

Attendez que la version du modèle de service soit correctement enregistrée.

Lorsque cette commande revient avec un état de sortie égal à0, l'enregistrement de la version est terminé. Ceci est utile dans les scripts pour vous assurer que vous pouvez exécuter correctement la commande à l'étape suivante.

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

Publiez la version du modèle de service pour la rendre disponible pour la création de services.

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

Obtenez un exemple de fichier de spécifications pour le modèle d'environnement que vous avez enregistré.

Vous pouvez télécharger le fichier environment-templates/fargate-env/spec/spec.yaml depuis le référentiel d'exemples de modèles. Vous pouvez également récupérer l'intégralité du référentiel localement et exécuter la create-environment commande depuis le environment-templates/fargate-env répertoire.

Créez un environnement.

AWS Proton lit les valeurs d'entrée de votre spécification d'environnement, les combine avec votre modèle d'environnement et fournit des ressources d'environnement dans votre AWS compte à l'aide de votre rôle AWS Proton de service.

$ 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"

Attendez que l'environnement soit correctement déployé.

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

Obtenez un exemple de fichier de spécifications pour le modèle de service que l'administrateur a enregistré.

Vous pouvez télécharger le fichier service-templates/load-balanced-fargate-svc/spec/spec.yaml depuis le référentiel d'exemples de modèles. Vous pouvez également récupérer l'intégralité du référentiel localement et exécuter la create-service commande depuis le service-templates/load-balanced-fargate-svc répertoire.

Intégrez le référentiel AWS Proton Sample Services à votre GitHub compte ou à votre organisation. Ce référentiel inclut le code source de l'application que nous utilisons dans ce didacticiel.

Créer un service.

AWS Proton lit les valeurs d'entrée de votre spécification de service, les combine avec votre modèle de service et provisionne les ressources de service de votre AWS compte dans l'environnement spécifié dans la spécification. Un AWS CodePipeline pipeline déploie le code de votre application à partir du référentiel que vous spécifiez dans la commande.

$ 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"

Attendez que le service soit correctement déployé.

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

Récupérez les résultats et consultez votre nouveau site Web.

Exécutez la commande suivante :

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

La sortie de la commande doit être similaire à la suivante :

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

La valeur de la sortie de l'ServiceURLinstance est le point de terminaison de votre nouveau site Web de service. Utilisez votre navigateur pour y accéder. Le graphique suivant devrait apparaître sur une page statique :

Pour supprimer le service, exécutez la commande suivante :

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

Pour supprimer l'environnement, exécutez la commande suivante :

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

Pour supprimer le modèle de service, exécutez les commandes suivantes :

$ 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"

Pour supprimer le modèle d'environnement, exécutez les commandes suivantes :

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