Phase "Verwalteter Build" hinzufügen
Fügen Sie der Build-Pipeline eine Managed Build-Phase hinzu.
In dieser Phase müssen Sie Code-Repositorys für den Build hinzufügen. Die Repositorys müssen konfiguriert werden, bevor die Phase "Verwalteter Build" hinzugefügt wird. Informationen zum Erstellen von Repositorys finden Sie unter Code-Repositorys verwalten.
Bevor Sie eine Phase hinzufügen, benötigen Sie eine Build-Pipeline.
Informationen zum Zugriff auf DevOps über die Oracle Cloud-Konsole, die REST-API und die CLI finden Sie unter Auf DevOps zugreifen.
- Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter DevOps auf Projekte.
- Wählen Sie ein Projekt und eine Build-Pipeline aus.
- Um der Pipeline eine Phase hinzuzufügen, klicken Sie auf das Plussymbol, und wählen Sie Phase hinzufügen aus.
- Wählen Sie als Phasentyp Verwalteter Build aus, und klicken Sie dann auf Weiter.
- Geben Sie einen Namen und eine Beschreibung für die Phase ein. Das Hinzufügen einer Beschreibung ist optional.
- Wählen Sie die Build-Runner-Ausprägung aus.
Sie können die Standardausprägung (schnelle Startoption) auswählen oder die Ausprägung anpassen, indem Sie die erforderliche OCPU-Anzahl und die Arbeitsspeichermenge (in GB) auswählen. Bei angepasster Ausprägung dauert das Provisioning länger.
- Wählen Sie Oracle Linux 7 als Basiscontainerimage aus.
- (Optional) So greifen Sie auf das private virtuelle Netzwerk zu:
- Wählen Sie ein virtuelles Cloud-Netzwerk (VCN) und ein regionales Subnetz im Mandanten aus.
- (Optional) Um den Zugriff auf das VCN einzuschränken, können Sie Netzwerksicherheitsgruppen (NSGs) in den VCNs auswählen.
Die interne DNS-(Domain Name System-)Auflösung von VCNs wird für den privaten Zugriff nicht unterstützt. Verwenden Sie IPs für die Kommunikation mit Services, die im privaten Netzwerk gehostet werden.
- (Optional) Geben Sie den Pfad zur Build-Spezifikationsdatei ein.
Die Build-Spezifikation enthält Build-Schritte und -Einstellungen, die von der Build-Pipeline zum Ausführen eines Builds verwendet werden.
Hinweis
Dieser Schritt ist nur erforderlich, wenn sich die Build-Spezifikationsdateibuild_spec.yaml
sich nicht im Root-Verzeichnis des primären Code-Repositorys befindet. - Wählen Sie das primäre Code-Repository für den Build aus.
- Wählen Sie den Verbindungstyp und eine Verbindung für das Repository aus. Die folgenden Verbindungstypen werden unterstützt:
- OCI-Code-Repository
- GitHub
- GitLab
- Bitbucket Cloud
- Visual Builder Studio
- Bitbucket Server
- GitLab Server
Nur die externen Verbindungen, die Sie bereits konfiguriert haben, stehen zur Auswahl. Wenn keine Verbindungen vorhanden sind, klicken Sie auf den Link Verbindung erstellen.
- Wenn Sie GitHub oder GitLab auswählen, wählen Sie ein Repository aus.
- Wenn Sie Bitbucket Cloud auswählen, geben Sie einen Workspace und ein Repository an.
- Wenn Sie Visual Builder Studio (VBS) auswählen, geben Sie ein externes VBS-Projekt und ein Repository an.
- Wenn Sie Bitbucket Server oder GitLab Server auswählen, geben Sie die Repository-URL mit der Build-Quelle ein.
- Wählen Sie eine Verzweigung für das ausgewählte Code-Repository aus, oder geben Sie sie ein.
Der Build erfolgt in der Verzweigung, die den Build-Run auslöst, und nicht in der Verzweigung, die beim Hinzufügen der Build-Phase konfiguriert wurde. Die konfigurierte Verzweigung kann verwendet werden, wenn die Build-Ausführung manuell über die OCI-Konsole ausgelöst wird.
- Geben Sie unter Build-Quellenname einen eindeutigen Namen für den Ordner ein, in den der Quellcode auf dem Build Runner heruntergeladen wird. Beispiele:
Source1, Source2
. - Speichern Sie die Änderungen.
- Wählen Sie den Verbindungstyp und eine Verbindung für das Repository aus. Die folgenden Verbindungstypen werden unterstützt:
- Um weitere Code-Repositorys hinzuzufügen, klicken Sie auf Build-Quelle hinzufügen, und wählen Sie die Repositorys aus.
- (Optional) Geben Sie einen Timeoutwert (in Sekunden) für die Phase ein.
- (Optional) Um der Phase Tags hinzuzufügen, klicken Sie auf Taggingoptionen anzeigen. Tagging ist ein Metadaten-System, mit dem Sie die Ressourcen im Mandanten organisieren und verfolgen können.
Wenn Sie über Berechtigungen zum Erstellen von Ressourcen verfügen, sind Sie auch berechtigt, Freiformtags hinzuzufügen.
Um ein definiertes Tag hinzuzufügen, benötigen Sie Berechtigungen zum Verwenden des Tag-Namespace.
Weitere Informationen finden Sie unter Ressourcentags.
- Um der Pipeline die Phase hinzuzufügen, klicken Sie auf Hinzufügen.
Eine Phasenvorschau enthält einen Snapshot der Konfiguration.
Sie können der Pipeline die folgenden Phasen sequenziell oder parallel hinzufügen: - Artefakte übermitteln: Speichern Sie die Softwareanwendungen, die in der Phase "Verwaltet" erstellt wurden, in Oracle Cloud Infrastructure (OCI) Artifact Registry- oder OCI Container Registry-Repositorys.
- Deployment auslösen: Starten Sie eine Deployment-Pipeline, um die Ausgabe aus der Build-Pipeline bereitzustellen.
- Warten: Halten Sie die Build-Pipeline für eine bestimmte Zeit an, um sie zu testen.
Sie können den Build manuell ausführen oder automatisch eine Build-Ausführung auslösen, wenn Sie die Änderungen im Code-Repository festschreiben. Bei der manuellen Ausführung wird der letzte Commit für das Code-Repository verwendet. Sie können den Build basierend auf einem bestimmten Commit ausführen, indem Sie die Commit-Details angeben.
Um eine Build-Pipeline zu erstellen, führen Sie den Befehl
create
aus:oci devops build-pipeline create --project-id
Um die Phase "Verwalteter Build" für die Pipeline hinzuzufügen, führen Sie den Befehl
create-build-stage
aus:oci devops build-pipeline-stage create-build-stage
Erforderliche Parameter:
--build-pipeline-id
--build-source-collection
--image
--stage-predecessor-collection
Optionaler Parameter zum Konfigurieren der Build-Runner-Ausprägung:
--build-runner-config
So rufen Sie alle Befehle für
build-pipeline
undbuild-pipeline-stage
ab:oci devops build-pipeline -h
oci devops build-pipeline-stage -h
So erhalten Sie Hilfe für den Befehl
create-build-stage
:oci devops build-pipeline-stage create-build-stage -h
Um eine Build-Pipeline zu erstellen, verwenden Sie den Vorgang
CreateBuildPipeline
.Um die Phase "Verwalteter Build" für die Pipeline hinzuzufügen, verwenden Sie den Vorgang
CreateBuildPipelineStage
. Geben Sie für das AttributbuildPipelineStageType
den WertBUILD
an.Zusätzlich zur Anforderung CreateBuildStageDetails müssen Sie eines der angegebenen Attribute hinzufügen, um die Build-Runner-Ausprägung anzupassen:
.buildRunnerShapeConfig(CustomBuildRunnerShapeConfig.builder().ocpus(<no_of_ocpus>).memoryInGBs(<memory_in_gbs>).build())
.buildRunnerShapeConfig(DefaultBuildRunnerShapeConfig.builder().build())