Oracle Cloud Infrastructure-Dokumentation

Helm-Chart hinzufügen

Ein Helm-Chart muss im OCI Container Registry-Repository gespeichert sein, damit es für ein Deployment hinzugefügt werden kann. Sie können ein Helm-Chart verpacken und in die Container Registry aus der Build-Pipeline übertragen. Weitere Informationen finden Sie unter Phase "Verwalteter Build" hinzufügen. Informationen zum Deployment finden Sie unter Helm-Chart bereitstellen.

Die Integrität eines Helm-Charts kann vor dem Deployment überprüft werden. Dazu muss das Helm-Chart über ein gültiges Pretty Good Privacy-(PGP-)Schlüsselpaar im Binärformat signiert werden. Siehe Herkunft und Integrität von Helm. Der Public Key kann in einem OCI-Vault gespeichert oder inline angegeben werden. Wenn der Public Key beim Hinzufügen des Helm-Chart-Artefakts angegeben wird, erfolgt die Verifizierung vor dem Deployment des Helm-Charts. Wenn die Prüfung nicht erfolgreich verläuft, wird das Helm-Chart nicht bereitgestellt.

Sie müssen eine Artefaktreferenz erstellen, die auf den Repository-Speicherort des Helm-Charts verweist. Bevor Sie eine Artefaktreferenz erstellen, benötigen Sie ein DevOps-Projekt.

Informationen zum Zugriff auf DevOps über die Oracle Cloud-Konsole, die REST-API und die CLI finden Sie unter Auf DevOps zugreifen.

    1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter DevOps auf Projekte.
    2. Wählen Sie auf der Seite DevOps Projekte das Projekt aus, für das Sie ein Artefakt hinzufügen möchten.
    3. Klicken Sie auf der Detailseite des Projekts auf der linken Seite auf Artefakte.
    4. Klicken Sie auf der Seite Artefakte auf Artefakt hinzufügen.
    5. Geben Sie im Bereich Artefakt hinzufügen die folgenden Details an:
      1. Geben Sie einen Namen für das Artefakt ein.
      2. Wählen Sie unter Typ die Option Helm-Chart aus.
      3. Geben Sie die Helm-Diagramm-URL ein.

        Beispiel: oci://<region-key>.ocir.io/<tenancy-namespace>/<repo-name> ist die URL eines Helm-Diagramms im OCI Container Registry-Repository. <repo-name> ist hier ein Repository in Container Registry.

      4. Geben Sie die bereitzustellende Helm-Diagrammversion ein.

        Befolgen Sie das Format Semantische Versionierung, während Sie die Version angeben. Sie können den Versionswert mit dem regulären Ausdruck ^v?([0-9]+)(\.[0-9]+)?(\.[0-9]+)?(-([0-9A-Za-z\-]+(\.[0-9A-Za-z\-]+)*))?(\+([0-9A-Za-z\-]+(\.[0-9A-Za-z\-]+)*))?$ validieren.

        Sie können auch die Chart-Version zur Laufzeit angeben, indem Sie den Wert als ${chartVersion} angeben.

      5. (Optional) Wählen Sie eine der angegebenen Optionen aus, um das Helm-Chart zu prüfen:
        1. Keine: Keine Validierung.
        2. Vault: Wählen Sie den OCI-Vault und das Vault Secret aus, in dem der Public Key gespeichert ist.
        3. Inline-Public Key: Geben Sie den aktuellen Public Key ein, der in base64 codiert ist. Sie können auch die vorherige Version des Public Keys angeben, der für die Schlüsselrotation verwendet werden soll.
      6. (Optional) Um dem Artefakt 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, diesen Ressourcen Freiformtags hinzuzufügen.

        Um ein definiertes Tag hinzuzufügen, benötigen Sie Berechtigungen zum Verwenden des Tag-Namespace.

        Weitere Informationen finden Sie unter Ressourcentags.

    6. Klicken Sie auf Hinzufügen.

  • Führen Sie den Befehl create-helm-repository-artifact aus, um ein Helm-Chart hinzuzufügen:

    oci devops deploy-artifact create-helm-repository-artifact

    Erforderliche Parameter:

    • --argument-substitution-mode

      Geben Sie einen Wert als NONE an.

    • --artifact-chart-url
    • --artifact-version
    • --artifact-type
    • --project-id

    So rufen Sie alle Befehle für deploy-artifact ab:

    oci devops deploy-artifact -h

    So erhalten Sie Hilfe für den Befehl create-helm-repository-artifact:

    oci devops deploy-artifact create-helm-repository-artifact -h

  • Verwenden Sie den Vorgang CreateDeployArtifact, um ein Helm-Chart hinzuzufügen. Geben Sie für das Attribut deployArtifactType den Wert HELM_CHART an.