Exécutez des builds sur des flottes à capacité réservée - AWS CodeBuild
Création d'un parc de capacités réservéesBonnes pratiquesPuis-je partager un parc de capacités réservées entre plusieurs CodeBuild projets ?Comment fonctionne le calcul basé sur les attributs ?Quelles régions prennent en charge les flottes à capacité réservée ?Comment configurer une flotte de macOS à capacité réservée ?Comment configurer une Amazon Machine Image (AMI) personnalisée pour un parc de capacités réservées ?Limitations des flottes à capacité réservée

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.

Exécutez des builds sur des flottes à capacité réservée

CodeBuild propose les flottes de calcul suivantes :

  • Flottes à la demande

  • Flottes de capacité réservée

Avec des flottes à la demande, CodeBuild fournit le calcul nécessaire à vos builds. Les machines sont détruites à la fin de la construction. Les flottes à la demande sont entièrement gérées et incluent des fonctionnalités de mise à l'échelle automatique pour faire face aux pics de demande.

Note

Les flottes à la demande ne sont pas compatibles avec macOS ou Windows Server 2022.

CodeBuild propose également des flottes de capacités réservées contenant des instances alimentées par Amazon EC2 et gérées par CodeBuild. Avec les flottes de capacité réservée, vous configurez un ensemble d'instances dédiées pour votre environnement de construction. Ces machines restent inactives, prêtes à traiter les builds ou les tests immédiatement et réduisent les durées de construction. Avec des flottes de capacité réservées, vos machines fonctionnent en permanence et continueront d'entraîner des coûts tant qu'elles seront approvisionnées.

Important

Quelle que soit la durée pendant laquelle vous exécutez une instance, les flottes de capacité réservée sont facturées initialement par instance, après quoi des coûts supplémentaires peuvent être associés. Pour de plus amples informations, veuillez consulter https://aws.amazon.com/codebuild/pricing/.

Rubriques

Création d'un parc de capacités réservées

Suivez les instructions ci-dessous pour créer un parc de capacités réservées.

Pour créer un parc de capacités réservées

  1. Connectez-vous à la AWS CodeBuild console AWS Management Console et ouvrez-la sur https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Dans le volet de navigation, choisissez Compute fleets, puis Create Fleet.

  3. Dans le champ de texte Calculer le nom du parc, saisissez le nom de votre parc.

  4. Dans le menu déroulant Système d'exploitation, sélectionnez le système d'exploitation.

  5. Dans le menu déroulant Architecture, sélectionnez l'architecture.

  6. Dans le menu déroulant Type d'environnement, choisissez le type d'environnement.

  7. Pour v CPUs, choisissez le nombre de v CPUs à inclure dans votre flotte.

  8. Pour Mémoire, choisissez la quantité de mémoire à inclure dans votre flotte.

  9. Pour Disk, choisissez la quantité d'espace disque à inclure dans votre parc.

  10. Pour fournir des performances d'E/S à faible latence, sélectionnez Utiliser le stockage d'instance NVMe SSD.

  11. Dans le champ de texte Capacité, entrez le nombre minimum d'instances dans le parc.

  12. Dans le champ Comportement de débordement, choisissez le comportement lorsque la demande dépasse la capacité du parc. Pour plus d’informations sur ces options, consultez Propriétés du parc à capacité réservée.

  13. (Facultatif) Dans Configuration supplémentaire, procédez comme suit :

    • Dans le menu déroulant VPC - facultatif, sélectionnez un VPC auquel votre CodeBuild flotte aura accès.

    • Dans le menu déroulant Sous-réseaux, sélectionnez les sous-réseaux à utiliser CodeBuild pour configurer votre configuration VPC.

    • Dans le menu déroulant Groupes de sécurité, sélectionnez les groupes de sécurité CodeBuild à utiliser pour fonctionner avec votre VPC.

    • Dans le champ Rôle de service de flotte, choisissez un rôle de service existant.

      Note

      Assurez-vous que votre rôle dans la flotte dispose des autorisations nécessaires. Pour de plus amples informations, veuillez consulter Autoriser un utilisateur à ajouter une politique d'autorisation pour un rôle de service de flotte.

    • Si vous avez choisi le système d'exploitation Amazon Linux, sélectionnez Définir les configurations de proxy (facultatif) pour appliquer le contrôle d'accès réseau à vos instances à capacité réservée.

    • Pour Comportement par défaut, choisissez d'autoriser ou de refuser le trafic sortant vers toutes les destinations par défaut.

    • Pour les règles de proxy, choisissez Ajouter une règle de proxy pour spécifier les domaines de destination ou IPs pour autoriser ou refuser le contrôle d'accès au réseau.

  14. Choisissez Créer un parc informatique.

  15. Une fois le parc informatique créé, créez un nouveau CodeBuild projet ou modifiez un projet existant. Dans Environnement, choisissez Capacité réservée sous Modèle de provisionnement, puis choisissez le parc spécifié sous Nom du parc.

Bonnes pratiques

Lorsque vous utilisez des flottes de capacité réservée, nous vous recommandons de suivre ces bonnes pratiques.

  • Nous vous recommandons d'utiliser le mode de cache source pour améliorer les performances de génération en mettant en cache la source.

  • Nous vous recommandons d'utiliser la mise en cache des couches Docker pour améliorer les performances de création en mettant en cache les couches Docker existantes.

Puis-je partager un parc de capacités réservées entre plusieurs CodeBuild projets ?

Oui, vous pouvez optimiser l'utilisation de la capacité d'une flotte en l'utilisant dans le cadre de plusieurs projets.

Important

Lorsque vous utilisez la fonctionnalité de capacité réservée, les données mises en cache sur les instances de flotte, y compris les fichiers source, les couches Docker et les répertoires mis en cache spécifiés dans les spécifications de construction, peuvent être accessibles aux autres projets du même compte. Cela est intentionnel et permet aux projets au sein d'un même compte de partager des instances de flotte.

Comment fonctionne le calcul basé sur les attributs ?

Si vous choisissez ATTRIBUTE_BASED_COMPUTE celui de votre flottecomputeType, vous pouvez spécifier les attributs dans un nouveau champ appelécomputeConfiguration. Ces attributs incluent vCPUs, la mémoire, l'espace disque et lemachineType. C'machineTypeest l'un GENERAL ou l'autreNVME. Après avoir spécifié un ou plusieurs des attributs disponibles, il CodeBuild choisira un type de calcul parmi les types d'instances pris en charge disponibles une fois finalisécomputeConfiguration.

Note

CodeBuild choisira l'instance la moins chère qui répond à toutes les exigences de saisie. La mémoire, le v CPUs et l'espace disque des instances choisies seront tous supérieurs ou égaux aux exigences d'entrée. Vous pouvez vérifier les problèmes résolus computeConfiguration dans le parc créé ou mis à jour.

Si vous saisissez un computeConfiguration qu'il n'est pas possible de satisfaire CodeBuild, vous recevrez une exception de validation. Notez également que le comportement de dépassement de flotte à la demande sera remplacé par le comportement de file d'attente s'il n'computeConfigurationest pas disponible pour la demande.

Quelles régions prennent en charge les flottes à capacité réservée ?

Capacité réservée Les flottes Amazon Linux et Windows sont prises en charge dans les pays suivants Régions AWS : USA Est (Virginie du Nord), USA Est (Ohio), USA Ouest (Oregon), Asie-Pacifique (Mumbai), Asie-Pacifique (Singapour), Asie-Pacifique (Sydney), Asie-Pacifique (Tokyo), Europe (Francfort), Europe (Irlande) et Amérique du Sud (São Paulo). Pour plus d'informations sur Régions AWS les CodeBuild zones disponibles, consultez la section AWS Services par région.

Capacité réservée Les flottes macOS Medium sont prises en charge dans les pays suivants Régions AWS : USA Est (Virginie du Nord), USA Est (Ohio), USA Ouest (Oregon), Asie-Pacifique (Sydney) et Europe (Francfort). Capacité réservée Les grandes flottes macOS sont prises en charge dans les pays suivants Régions AWS : USA Est (Virginie du Nord), USA Est (Ohio), USA Ouest (Oregon) et Asie-Pacifique (Sydney).

Comment configurer une flotte de macOS à capacité réservée ?

Pour configurer un parc macOS à capacité réservée

  1. Connectez-vous à la AWS CodeBuild console AWS Management Console et ouvrez-la sur https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Dans le volet de navigation, choisissez Compute fleets, puis Create Fleet.

  3. Dans le champ de texte Calculer le nom du parc, saisissez le nom de votre parc.

  4. Dans le menu déroulant Système d'exploitation, sélectionnez macOS.

  5. Dans le champ Calcul, sélectionnez l'un des types de machines de calcul suivants : Apple M2, 24 Go de mémoire, 8 V CPUs ou Apple M2, 32 Go de mémoire, 12 CPUs V.

  6. Dans le champ de texte Capacité, entrez le nombre minimum d'instances dans le parc.

  7. (Facultatif) Pour utiliser une image personnalisée pour votre flotteComment configurer une Amazon Machine Image (AMI) personnalisée pour un parc de capacités réservées ?, assurez-vous que votre Amazon Machine Image (AMI) répond aux exigences requises.

  8. (Facultatif) Pour configurer un VPC avec votre flotte, dans Configuration supplémentaire, procédez comme suit :

    • Dans le menu déroulant VPC - facultatif, sélectionnez un VPC auquel votre CodeBuild flotte aura accès.

    • Dans le menu déroulant Sous-réseaux, sélectionnez les sous-réseaux à utiliser CodeBuild pour configurer votre configuration VPC.

    • Dans le menu déroulant Groupes de sécurité, sélectionnez les groupes de sécurité CodeBuild à utiliser pour fonctionner avec votre VPC.

    • Dans le champ Rôle de service de flotte, choisissez un rôle de service existant.

      Note

      Assurez-vous que votre rôle dans la flotte dispose des autorisations nécessaires. Pour de plus amples informations, veuillez consulter Autoriser un utilisateur à ajouter une politique d'autorisation pour un rôle de service de flotte.

  9. Choisissez Créer une flotte de calcul et attendez que l'instance de flotte soit lancée. Une fois lancée, la capacité seran/n, où n est la capacité fournie ?

  10. Une fois le parc informatique lancé, créez un nouveau CodeBuild projet ou modifiez un projet existant. Dans Environnement, choisissez Capacité réservée sous Modèle de provisionnement, puis choisissez le parc spécifié sous Nom du parc.

Comment configurer une Amazon Machine Image (AMI) personnalisée pour un parc de capacités réservées ?

Pour configurer une Amazon Machine Image (AMI) personnalisée pour un parc de capacités réservées

  1. Connectez-vous à la AWS CodeBuild console AWS Management Console et ouvrez-la sur https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Dans le volet de navigation, choisissez Compute fleets, puis Create Fleet.

  3. Dans le champ de texte Calculer le nom du parc, saisissez le nom de votre parc.

  4. Choisissez une image personnalisée pour votre flotte et assurez-vous que votre Amazon Machine Image (AMI) répond aux exigences suivantes :

    • Si votre type d'environnement est MAC_ARM le cas, assurez-vous que votre architecture AMI est 64 bitsMac-Arm.

    • Si votre type d'environnement est LINUX_EC2 le cas, assurez-vous que votre architecture AMI est 64 bitsx86.

    • Si votre type d'environnement est ARM_EC2 le cas, assurez-vous que votre architecture AMI est 64 bitsArm.

    • Si votre type d'environnement est WINDOWS_EC2 le cas, assurez-vous que votre architecture AMI est 64 bitsx86.

    • L'AMI autorise le CodeBuild service Organization ARN. Pour une liste des organisations ARNs, voirAmazon Machine Images (AMI).

    • Si l'AMI est chiffrée à l'aide d'une AWS KMS clé, AWS KMS celle-ci doit également autoriser l'ID d'organisation du CodeBuild service. Pour une liste des organisations IDs, voirAmazon Machine Images (AMI). Pour plus d'informations sur AWS KMS les clés, consultez Autoriser les organisations et OUs utiliser une clé KMS dans le guide de EC2 l'utilisateur Amazon. Pour autoriser CodeBuild l'organisation à utiliser une clé KMS, ajoutez la déclaration suivante à la politique de clé :

      {
    "Sid": "Allow access for organization root",
    "Effect": "Allow",
    "Principal": "*",
    "Action": [
        "kms:Describe*",
        "kms:List*",
        "kms:Get*",
        "kms:Encrypt",
        "kms:Decrypt",
        "kms:ReEncrypt*",
        "kms:GenerateDataKey*",
        "kms:CreateGrant"
    ],
    "Resource": "*",
    "Condition": {
        "StringEquals": {
            "aws:PrincipalOrgID": "o-123example"
        }
    }
}

    • Dans le champ Rôle du service Fleet, accordez les EC2 autorisations Amazon suivantes :

      {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
               "ec2:DescribeImages",
               "ec2:DescribeSnapshots"
            ],
            "Resource": "*"
        }
    ]
}

Limitations des flottes à capacité réservée

Il existe certains cas d'utilisation que les flottes de capacité réservée ne prennent pas en charge, et s'ils vous concernent, utilisez plutôt des flottes à la demande :

  • Les flottes de capacité réservée ne prennent pas en charge les indicateurs d'utilisation des builds.

  • Les flottes de macOS à capacité réservée ne prennent pas en charge les sessions de débogage.

Pour plus d'informations sur les limites et les quotas, consultezFlottes informatiques.