View a markdown version of this page

Führen Sie Builds auf Flotten mit reservierter Kapazität aus - AWS CodeBuild
Erstellen Sie eine Flotte mit reservierter KapazitätBewährte MethodenKann ich eine Flotte mit reservierter Kapazität für mehrere Projekte gemeinsam nutzen? CodeBuildWie funktioniert attributbasiertes Rechnen?Kann ich manuell eine Amazon EC2-Instance für meine Flotte angeben?Welche Regionen unterstützen Flotten mit reservierter Kapazität?Wie konfiguriere ich eine macOS-Flotte mit reservierter Kapazität?Wie konfiguriere ich ein benutzerdefiniertes Amazon Machine Image (AMI) für eine Flotte mit reservierter Kapazität?Einschränkungen der Flotten mit reservierter Kapazität

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Führen Sie Builds auf Flotten mit reservierter Kapazität aus

CodeBuild bietet die folgenden Rechenflotten:

  • On-demand Flotten

  • Flotten mit reservierter Kapazität

CodeBuild Bietet mit bedarfsgesteuerten Flotten Rechenleistung für Ihre Builds. Die Maschinen werden zerstört, wenn der Bau abgeschlossen ist. On-demand Die Flotten werden vollständig verwaltet und verfügen über automatische Skalierungsfunktionen, um Nachfragespitzen zu bewältigen.

Anmerkung

On-demand Flotten unterstützen macOS nicht.

CodeBuild bietet auch Flotten mit reservierter Kapazität an, die Instances enthalten, die von Amazon EC2 betrieben werden und von verwaltet werden. CodeBuild Bei Flotten mit reservierter Kapazität konfigurieren Sie eine Reihe von dedizierten Instances für Ihre Build-Umgebung. Diese Maschinen bleiben im Leerlauf und sind bereit, Builds oder Tests sofort zu verarbeiten und reduzieren die Builddauer. Mit Flotten mit reservierter Kapazität sind Ihre Maschinen ständig in Betrieb und es fallen weiterhin Kosten an, solange sie bereitgestellt werden.

Wichtig

Unabhängig davon, wie lange Sie eine Instance ausführen, fallen für Flotten mit reservierter Kapazität eine anfängliche Gebühr pro Instance an. Danach können zusätzliche Kosten anfallen. Weitere Informationen finden Sie unter https://aws.amazon.com/codebuild/pricing/.

Themen

Erstellen Sie eine Flotte mit reservierter Kapazität

Verwenden Sie die folgenden Anweisungen, um eine Flotte mit reservierter Kapazität zu erstellen.

Um eine Flotte mit reservierter Kapazität zu erstellen

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die AWS CodeBuild Konsole unter https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Wählen Sie im Navigationsbereich Flotten berechnen und dann Flotte erstellen aus.

  3. Geben Sie im Textfeld Flottenname berechnen einen Namen für Ihre Flotte ein.

  4. Wählen Sie im Dropdownmenü Betriebssystem das Betriebssystem aus.

  5. Wählen Sie im Dropdownmenü Architektur die Architektur aus.

  6. (Optional) Wählen Sie Instanz-Ausführungsmodus verwenden aus — optional, um die Ausführung direkt auf einer Amazon EC2-Instance statt auf einem Docker-Container durchzuführen. Wählen Sie dann eine Hauptversion und eine Nebenversion.

  7. (Optional) Gehen Sie unter Zusätzliche Konfiguration wie folgt vor:

    • Wählen Sie VPC konfigurieren — optional, um Ihre Flotte mit einer VPC zu verbinden und während der Nutzung auf private Ressourcen zuzugreifen.

      • Wählen Sie im Dropdownmenü VPC eine VPC aus, auf die Ihre CodeBuild Flotte zugreifen soll.

      • Wählen Sie im Dropdownmenü Subnetze die Subnetze aus, die für die Einrichtung Ihrer CodeBuild VPC-Konfiguration verwendet werden sollen.

      • Wählen Sie im Dropdownmenü Sicherheitsgruppen die Sicherheitsgruppen aus, die für die Arbeit mit CodeBuild Ihrer VPC verwendet werden sollen.

      • Wählen Sie im Feld Fleet Service Role eine vorhandene Servicerolle aus.

        Anmerkung

        Vergewissern Sie sich, dass Ihre Flottenfunktion über die erforderlichen Berechtigungen verfügt. Weitere Informationen finden Sie unter Erlauben Sie einem Benutzer, eine Berechtigungsrichtlinie für eine Flottenservice-Rolle hinzuzufügen.

      • Wenn Sie sich für das Amazon Linux-Betriebssystem entschieden haben, wählen Sie Proxykonfigurationen definieren — optional, um die Netzwerkzugriffskontrolle für Ihre Instances mit reservierter Kapazität anzuwenden.

      • Wählen Sie für das Standardverhalten aus, ob ausgehender Datenverkehr an alle Ziele standardmäßig zugelassen oder verweigert werden soll.

      • Wählen Sie für Proxyregeln die Option Proxyregel hinzufügen aus, um Zieldomänen oder IPs anzugeben, für die die Netzwerkzugriffskontrolle zugelassen oder verweigert werden soll.

    • Wählen Sie Benutzerdefiniertes AMI konfigurieren — optional, um ein benutzerdefiniertes Amazon Machine Image (AMI) zu verwenden.

  8. Wählen Sie in der Kapazitätskonfiguration im Auswahlmodus Berechnen eine der folgenden Optionen aus:

    • Wenn Sie Geführte Auswahl wählen, gehen Sie wie folgt vor:

      • Wählen Sie für Compute den Instance-Typ aus, der in dieser Flotte enthalten ist.

      • Geben Sie im Textfeld Kapazität die Mindestanzahl von Instances in der Flotte ein.

      • (Optional) Gehen Sie unter Zusätzliche Konfiguration wie folgt vor:

        • Wählen Sie Skalierung konfigurieren — optional, um Ihre Flotte automatisch auf der Grundlage dieser Konfiguration zu skalieren. Wählen Sie im Dropdownmenü Skalierungsmodus — optional das Verhalten aus, wenn die Nachfrage die Flottenkapazität übersteigt.

    • Wenn Sie „Benutzerdefinierte Instanz“ wählen, gehen Sie wie folgt vor:

      • Wählen Sie im Dropdownmenü Compute-Instance-Typ den Instance-Typ aus, der in dieser Flotte enthalten ist.

      • Geben Sie in das Textfeld Zusätzliche EBS-Volumegröße — optional das Volume ein, das zusätzlich zu den bereitgestellten 64 GB Festplattenspeicher hinzukommt.

      • Geben Sie im Textfeld Kapazität die Mindestanzahl von Instances in der Flotte ein.

      • (Optional) Gehen Sie unter Zusätzliche Konfiguration wie folgt vor:

        • Wählen Sie Skalierung konfigurieren — optional, um Ihre Flotte automatisch auf der Grundlage dieser Konfiguration zu skalieren. Wählen Sie im Dropdownmenü Skalierungsmodus — optional das Verhalten aus, wenn die Nachfrage die Flottenkapazität übersteigt.

  9. Wählen Sie Computerflotte erstellen aus.

  10. Nachdem die Rechenflotte erstellt wurde, erstellen Sie ein neues CodeBuild Projekt oder bearbeiten Sie ein vorhandenes. Wählen Sie unter Umgebung unter Bereitstellungsmodell die Option Reservierte Kapazität aus und wählen Sie dann unter Flottenname die angegebene Flotte aus.

Bewährte Methoden

Wenn Sie Flotten mit reservierter Kapazität verwenden, empfehlen wir Ihnen, diese bewährten Methoden zu befolgen.

  • Wir empfehlen, den Quell-Cache-Modus zu verwenden, um die Build-Leistung zu verbessern, indem die Quelle zwischengespeichert wird.

  • Wir empfehlen, das Docker-Layer-Caching zu verwenden, um die Build-Leistung zu verbessern, indem vorhandene Docker-Ebenen zwischengespeichert werden.

Kann ich eine Flotte mit reservierter Kapazität für mehrere Projekte gemeinsam nutzen? CodeBuild

Ja, Sie können die Auslastung der Kapazität einer Flotte maximieren, indem Sie sie für mehrere Projekte verwenden.

Wichtig

Wenn Sie die Funktion für reservierte Kapazität verwenden, können andere Projekte innerhalb desselben Kontos auf Daten, die auf Flotteninstanzen zwischengespeichert sind, einschließlich Quelldateien, Docker-Ebenen und zwischengespeicherten Verzeichnissen, die in der Buildspec angegeben sind, zugreifen. Dies ist beabsichtigt und ermöglicht es Projekten innerhalb desselben Kontos, Flotteninstanzen gemeinsam zu nutzen.

Wie funktioniert attributbasiertes Rechnen?

Wenn Sie die Attribute für Ihre Flotte auswählen ATTRIBUTE_BASED_COMPUTEcomputeType, können Sie die Attribute in einem neuen Feld mit dem Namen angeben. computeConfiguration Zu diesen Attributen gehören vCPUs, Arbeitsspeicher, Festplattenspeicher und die. machineType Das machineType ist entweder oderGENERAL. NVME Nachdem Sie eines oder mehrere der verfügbaren Attribute angegeben haben, CodeBuild wird ein Berechnungstyp aus den verfügbaren unterstützten Instance-Typen als finalisiert computeConfiguration ausgewählt.

Anmerkung

CodeBuild wählt die günstigste Instanz aus, die allen Eingabeanforderungen entspricht. Der Arbeitsspeicher, die vCPUs und der Festplattenspeicher der ausgewählten Instanzen sind alle größer oder gleich den Eingabeanforderungen. Sie können die gelösten Probleme computeConfiguration in der erstellten oder aktualisierten Flotte überprüfen.

Wenn Sie ein Problem eingebencomputeConfiguration, das nicht erfüllt werden kann CodeBuild, erhalten Sie eine Validierungsausnahme. Beachten Sie auch, dass das Verhalten bei Flottenüberläufen bei Bedarf durch das Verhalten von Warteschlangen ersetzt wird, wenn das nicht auf Abruf verfügbar computeConfiguration ist.

Kann ich manuell eine Amazon EC2-Instance für meine Flotte angeben?

Ja, Sie können Ihre gewünschte Amazon EC2-Instance direkt in die Konsole eingeben, indem Sie Benutzerdefinierte Instance auswählen oder den API-Parameter konfigurieren. InstanceType Dieses Feld wird in den folgenden APIs verwendet: CreateFleet UpdateFleet CreateProject, UpdateProject und StartBuild. Weitere Informationen finden Sie unter Compute instance type.

Welche Regionen unterstützen Flotten mit reservierter Kapazität?

Reservierte Kapazität Amazon Linux- und Windows-Flotten werden in den folgenden Ländern unterstützt AWS-Regionen: USA Ost (Nord-Virginia), USA Ost (Ohio), USA West (Oregon), Asien-Pazifik (Mumbai), Asien-Pazifik (Singapur), Asien-Pazifik (Sydney), Asien-Pazifik (Tokio), Europa (Frankfurt), Europa (Irland) und Südamerika (São Paulo). Weitere Informationen darüber, AWS-Regionen wo verfügbar CodeBuild ist, finden Sie unter AWS Dienste nach Regionen.

macOS Medium-Flotten mit reservierter Kapazität werden in den folgenden Ländern unterstützt AWS-Regionen: USA Ost (Nord-Virginia), USA Ost (Ohio), USA West (Oregon), Asien-Pazifik (Sydney) und Europa (Frankfurt). MacOS Large-Flotten mit reservierter Kapazität werden in den folgenden Ländern unterstützt AWS-Regionen: USA Ost (Nord-Virginia), USA Ost (Ohio), USA West (Oregon) und Asien-Pazifik (Sydney).

Wie konfiguriere ich eine macOS-Flotte mit reservierter Kapazität?

Um eine macOS-Flotte mit reservierter Kapazität zu konfigurieren

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die AWS CodeBuild Konsole unter https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Wählen Sie im Navigationsbereich Flotten berechnen und dann Flotte erstellen aus.

  3. Geben Sie im Textfeld Flottenname berechnen einen Namen für Ihre Flotte ein.

  4. Wählen Sie im Dropdownmenü Betriebssystem die Option macOS aus.

  5. Wählen Sie im Feld Compute einen der folgenden Computertypen aus: Apple M2, 24 GB Arbeitsspeicher, 8 vCPUs oder Apple M2, 32 GB Arbeitsspeicher, 12 vCPUs.

  6. Geben Sie im Textfeld Kapazität die Mindestanzahl von Instances in der Flotte ein.

  7. (Optional) Informationen zur Verwendung eines benutzerdefinierten Images für Ihre Flotte finden Sie unter Wie konfiguriere ich ein benutzerdefiniertes Amazon Machine Image (AMI) für eine Flotte mit reservierter Kapazität? So stellen Sie sicher, dass Ihr Amazon Machine Image (AMI) die erforderlichen Voraussetzungen erfüllt.

  8. (Optional) Gehen Sie unter Zusätzliche Konfiguration wie folgt vor, um eine VPC mit Ihrer Flotte zu konfigurieren:

    • Wählen Sie im Dropdownmenü VPC — optional eine VPC aus, auf die Ihre CodeBuild Flotte zugreifen soll.

    • Wählen Sie im Dropdownmenü Subnetze die Subnetze aus, die Sie für die Einrichtung CodeBuild Ihrer VPC-Konfiguration verwenden sollen.

    • Wählen Sie im Dropdownmenü Sicherheitsgruppen die Sicherheitsgruppen aus, die für die Arbeit mit CodeBuild Ihrer VPC verwendet werden sollen.

    • Wählen Sie im Feld Flotten-Servicerolle eine vorhandene Servicerolle aus.

      Anmerkung

      Vergewissern Sie sich, dass Ihre Flottenfunktion über die erforderlichen Berechtigungen verfügt. Weitere Informationen finden Sie unter Erlauben Sie einem Benutzer, eine Berechtigungsrichtlinie für eine Flottenservice-Rolle hinzuzufügen.

  9. Wählen Sie Create Compute Fleet aus und warten Sie, bis die Flotteninstanz gestartet ist. Nach dem Start wird die Kapazität angezeigt. Wo n ist die Kapazitätn/n, die zur Verfügung gestellt wird.

  10. Erstellen Sie nach dem Start der Rechenflotte ein neues CodeBuild Projekt oder bearbeiten Sie ein vorhandenes. Wählen Sie unter Umgebung unter Bereitstellungsmodell die Option Reservierte Kapazität aus und wählen Sie dann unter Flottenname die angegebene Flotte aus.

Wie konfiguriere ich ein benutzerdefiniertes Amazon Machine Image (AMI) für eine Flotte mit reservierter Kapazität?

Um ein benutzerdefiniertes Amazon Machine Image (AMI) für eine Flotte mit reservierter Kapazität zu konfigurieren

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die AWS CodeBuild Konsole unter https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Wählen Sie im Navigationsbereich Flotten berechnen und dann Flotte erstellen aus.

  3. Geben Sie im Textfeld Flottenname berechnen einen Namen für Ihre Flotte ein.

  4. Wählen Sie Benutzerdefiniertes Image für Ihre Flotte und stellen Sie sicher, dass Ihr Amazon Machine Image (AMI) die folgenden Voraussetzungen erfüllt:

    • Wenn Ihr Umgebungstyp istMAC_ARM, stellen Sie sicher, dass Ihre AMI-Architektur 64-Bit istMac-Arm.

    • Wenn Ihr Umgebungstyp istLINUX_EC2, stellen Sie sicher, dass Ihre AMI-Architektur 64-Bit istx86.

    • Wenn Ihr Umgebungstyp istARM_EC2, stellen Sie sicher, dass Ihre AMI-Architektur 64-Bit istArm.

    • Wenn Ihr Umgebungstyp istWINDOWS_EC2, stellen Sie sicher, dass Ihre AMI-Architektur 64-Bit istx86.

    • Das AMI erlaubt dem CodeBuild Service Organization ARN. Eine Liste der Organisations-ARNs finden Sie unterAmazon Machine Images (AMI).

    • Wenn das AMI mit einem AWS KMS Schlüssel verschlüsselt ist, muss der AWS KMS Schlüssel auch die Organisations-ID des CodeBuild Dienstes zulassen. Eine Liste der Organisations-IDs finden Sie unterAmazon Machine Images (AMI). Weitere Informationen zu AWS KMS Schlüsseln finden Sie im Amazon EC2-Benutzerhandbuch unter Erlauben Sie Organisationen und Organisationseinheiten, einen KMS-Schlüssel zu verwenden. Um der CodeBuild Organisation die Erlaubnis zur Verwendung eines KMS-Schlüssels zu erteilen, fügen Sie der Schlüsselrichtlinie die folgende Anweisung hinzu:

      {
    "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"
        }
    }
}

    • Gewähren Sie im Feld Fleet Service Role die folgenden Amazon EC2-Berechtigungen:

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

Einschränkungen der Flotten mit reservierter Kapazität

Es gibt einige Anwendungsfälle, die von Flotten mit reservierter Kapazität nicht unterstützt werden. Wenn Sie davon betroffen sind, verwenden Sie stattdessen Flotten auf Abruf:

  • Flotten mit reservierter Kapazität unterstützen keine Kennzahlen zur Build-Auslastung.

  • macOS-Flotten mit reservierter Kapazität unterstützen keine Debug-Sitzungen.

Weitere Informationen zu Grenzwerten und Kontingenten finden Sie unterComputerflotten.