Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Déployez le AWS ParallelCluster API avec AWS CLI Dans cette section, vous allez apprendre à déployer avec AWS CLI. Configurez les AWS informations d'identification à utiliser avec la CLI si ce n'est pas déjà fait. ``` $ aws configure ``` Exécutez les commandes suivantes pour déployer l'API : ``` $ REGION={{}} $ API_STACK_NAME={{}}  # This can be any name $ VERSION=3.16.1 $ aws cloudformation create-stack \   --region ${REGION} \   --stack-name ${API_STACK_NAME} \   --template-url https://${REGION}-aws-parallelcluster.s3.${REGION}.amazonaws.com/parallelcluster/${VERSION}/api/parallelcluster-api.yaml \   --capabilities CAPABILITY_NAMED_IAM CAPABILITY_AUTO_EXPAND $ aws cloudformation wait stack-create-complete --stack-name ${API_STACK_NAME} --region ${REGION} ``` **Personnalisez votre déploiement ** Vous pouvez utiliser les CloudFormation paramètres exposés par le modèle pour personnaliser le déploiement de l'API. Pour configurer la valeur d'un paramètre lorsque vous déployez via la CLI, l'option suivante peut être utilisée :`--parameters ParameterKey=KeyName,ParameterValue=Value`. Les paramètres suivants sont facultatifs : + **Région ** : utilisez le `Region` paramètre pour spécifier si l'API est capable de contrôler les ressources dans l'ensemble Régions AWS (par défaut) ou dans une seule Région AWS. Définissez cette valeur sur Région AWS l'API en cours de déploiement afin de restreindre l'accès. + **ParallelClusterFunctionRole**- Cela remplace le rôle IAM attribué à la AWS Lambda fonction qui implémente AWS ParallelCluster les fonctionnalités. Le paramètre accepte l'ARN d'un rôle IAM. Ce rôle doit être configuré pour être utilisé AWS Lambda comme principal IAM. De plus, étant donné que ce rôle remplacera le rôle par défaut de la fonction API Lambda, il doit disposer au moins des autorisations par défaut requises par l'API, comme indiqué dans[AWS ParallelCluster exemple de politiques utilisateur `de pcluster`](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-example-user-policies). + **ParallelClusterFunctionAdditionalPolicies**- ARN de la politique IAM supplémentaire à associer au rôle de fonction AWS ParallelCluster API. Une seule politique peut être spécifiée. + **CustomDomainName,CustomDomainCertificate, CustomDomainHostedZoneId ** - Utilisez ces paramètres pour définir un domaine personnalisé pour le point de terminaison Amazon API Gateway. `CustomDomainName`est le nom du domaine à utiliser, `CustomDomainCertificate` l'ARN d'un certificat AWS géré pour ce nom de domaine et `CustomDomainHostedZoneId` l'ID de la zone [ hébergée ](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/Welcome.html) Amazon Route 53 dans laquelle vous souhaitez créer des enregistrements. **Avertissement** Vous pouvez configurer des paramètres de domaine personnalisés pour appliquer une version minimale de Transport Layer Security (TLS) pour l'API. Pour plus d'informations, consultez la section [ Choix d'une version TLS minimale pour un domaine personnalisé dans API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-custom-domain-tls-version.html). + **EnableIamAdminAccess**- Par défaut, la AWS Lambda fonction qui traite les opérations d' AWS ParallelCluster API est configurée avec un rôle IAM qui empêche tout accès IAM privilégié ()`EnableIamAdminAccess=false`. Cela empêche l'API de traiter les opérations qui nécessitent la création de rôles ou de politiques IAM. De ce fait, la création de clusters ou d'images personnalisées n'est réussie que lorsque les rôles IAM sont fournis en entrée dans le cadre de la configuration des ressources. Lorsque cette `EnableIamAdminAccess` option est définie `true` sur l' AWS ParallelCluster API, des autorisations sont accordées pour gérer la création des rôles IAM nécessaires au déploiement de clusters ou à la génération d'AMI personnalisées. **Avertissement** Lorsque ce paramètre est défini sur true, les privilèges d'administrateur IAM sont accordés à la AWS Lambda fonction qui traite les AWS ParallelCluster opérations. Reportez-vous à [AWS ParallelCluster exemples de politiques utilisateur pour la gestion des ressources IAM](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-user-policy-manage-iam) pour plus de détails sur les fonctionnalités qui peuvent être déverrouillées lorsque vous activez ce mode. + **PermissionsBoundaryPolicy**- Ce paramètre facultatif accepte un ARN de stratégie IAM existant qui sera défini comme limite d'autorisations pour tous les rôles IAM créés par l'infrastructure API PC et comme condition sur les autorisations IAM administratives afin que seuls les rôles dotés de cette politique puissent être créés par l'API PC. Reportez-vous à [Mode `PermissionsBoundary`](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-permissionsboundary-mode) pour plus de détails sur les restrictions imposées par ce mode. + **CreateApiUserRole**- Par défaut, le déploiement de l' AWS ParallelCluster API inclut la création d'un rôle IAM qui est défini comme le seul rôle autorisé à invoquer l'API. Le point de terminaison Amazon API Gateway est configuré avec une politique basée sur les ressources afin d'accorder l'autorisation d'invocation à l'utilisateur créé uniquement. Pour modifier cela, définissez `CreateApiUserRole=false` puis accordez l'accès à l'API aux utilisateurs IAM sélectionnés. Pour plus d'informations, consultez la section [ Contrôler l'accès pour invoquer une API ](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-control-access-using-iam-policies-to-invoke-api.html) dans le manuel * Amazon API Gateway Developer Guide*. **Avertissement** Lorsque l'`CreateApiUserRole=true`accès au point de terminaison de l'API n'est pas limité par les politiques de ressources d'Amazon API Gateway, tous les rôles IAM disposant d'`execute-api:Invoke`autorisations illimitées peuvent accéder aux fonctionnalités. AWS ParallelCluster Pour plus d'informations, consultez la section [ Contrôle de l'accès à une API à l'aide des politiques de ressources API Gateway ](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-resource-policies.html) dans le Guide du développeur d'*API Gateway*. **Avertissement** `ParallelClusterApiUserRole`Il est autorisé à invoquer toutes les opérations AWS ParallelCluster d'API. Pour restreindre l'accès à un sous-ensemble de ressources d'API, consultez la section [ Contrôler qui peut appeler une méthode d'API API Gateway avec des politiques IAM ](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-control-access-using-iam-policies-to-invoke-api.html#api-gateway-who-can-invoke-an-api-method-using-iam-policies) dans le guide du développeur d'*API Gateway. * + **IAMRoleAndPolicyPrefix**- Ce paramètre facultatif accepte une chaîne contenant un maximum de 10 caractères qui sera utilisée comme préfixe pour les rôles IAM et les politiques créés dans le cadre de l'infrastructure API PC.