Environnements gérés par le client

Avec les environnements gérés par le client, vous pouvez utiliser l'infrastructure existante, telle qu'un VPC, que vous avez déjà déployée en tant queAWS Protonenvironnement. Lorsque vous utilisez des environnements gérés par le client, vous pouvez provisionner vos propres ressources partagées en dehors deAWS Proton. Toutefois, vous pouvez toujours autoriserAWS Protonpour utiliser les sorties de provisionnement pertinentes en tant qu'entrées pourAWS Protonservices lorsqu'ils sont déployés. Si les sorties peuvent changer,AWS Protonest en mesure d'accepter les mises à jour.AWS Protonn'est cependant pas en mesure de modifier directement l'environnement, étant donné que le provisionnement est géré en dehors deAWS Proton.

Une fois l'environnement créé, vous êtes responsable de fournir les mêmes résultats àAWS Protonqui aurait été créé siAWS Protonavait créé l'environnement, par exemple les noms de clusters Amazon ECS ou les identifiants Amazon VPC.

Grâce à cette fonctionnalité, vous pouvez déployer et mettre à jourAWS Protonressources de service provenant d'unAWS Protonmodèle de service pour cet environnement. Toutefois, l'environnement lui-même n'est pas modifié par les mises à jour des modèles dansAWS Proton. Vous êtes responsable de l'exécution des mises à jour de l'environnement et de la mise à jour de ces sorties dansAWS Proton.

Vous pouvez disposer de plusieurs environnements dans un seul compte, qui sont à la foisAWS Protonenvironnements gérés et gérés par le client. Vous pouvez également associer un deuxième compte et utiliser unAWS Protonmodèle dans le compte principal pour exécuter les déploiements et les mises à jour des environnements et des services de ce second compte lié.

Comment utiliser les environnements gérés par le client

La première chose que les administrateurs doivent faire est d'enregistrer un modèle d'environnement importé et géré par le client. Ne fournissez pas de manifestes ni de fichiers d'infrastructure dans le bundle de modèles. Fournissez uniquement le schéma.

Le schéma ci-dessous présente une liste de sorties utilisant le format API ouvert et reproduit les sorties d'unAWS CloudFormationmodèle.

Important

Seules les entrées de chaîne sont autorisées pour les sorties.

L'exemple suivant est un extrait des sections de sortie d'unAWS CloudFormationmodèle pour un modèle Fargate correspondant.

Outputs:
  ClusterName:
    Description: The name of the ECS cluster
    Value: !Ref 'ECSCluster'
  ECSTaskExecutionRole:
    Description: The ARN of the ECS role
    Value: !GetAtt 'ECSTaskExecutionRole.Arn'
  VpcId:
    Description: The ID of the VPC that this stack is deployed in
    Value: !Ref 'VPC'
[...]

Le schéma du fichier correspondantAWS Protonl'environnement importé est similaire au suivant. Ne fournissez pas de valeurs par défaut dans le schéma.

schema:
  format:
    openapi: "3.0.0"
  environment_input_type: "EnvironmentOutput"
  types:
    EnvironmentOutput:
      type: object
      description: "Outputs of the environment"
      properties:
        ClusterName:
          type: string
          description: "The name of the ECS cluster"
        ECSTaskExecutionRole:
          type: string
          description: "The ARN of the ECS role"
        VpcId:
          type: string
          description: "The ID of the VPC that this stack is deployed in"
[...]

Au moment de l'enregistrement du modèle, vous indiquez que ce modèle est importé et que vous indiquez l'emplacement du compartiment Amazon S3 pour le bundle.AWS Protonvérifie que le schéma contient uniquementenvironment_input_typeet nonAWS CloudFormationparamètres du modèle avant de le mettre en brouillon.

Vous devez fournir les informations suivantes pour créer un environnement importé.

• Un rôle IAM à utiliser lors de déploiements.

• Une spécification avec les valeurs pour les sorties requises.

Vous pouvez fournir ces deux options via la console ouAWS CLIen utilisant un processus similaire au déploiement d'un environnement normal.