Einbinden eines gitRepo-Volumes in Azure Container Instances

Artikel
10/15/2024

Hier erfahren Sie, wie Sie ein gitRepo-Volume einbinden, um ein Git-Repository in Ihren Containerinstanzen zu klonen.

Hinweis

Zurzeit ist das Einbinden eines gitRepo-Volumes auf Linux-Container beschränkt. Bis alle Features auch für Windows-Container verfügbar sind, finden Sie die aktuellen Plattformunterschiede in der Übersicht.

GitRepo-Volume

Das gitRepo-Volume bindet ein Verzeichnis ein und klont darin während der Containererstellung das angegebene Git-Repository. Bei Verwendung eines gitRepo-Volumes in Ihren Containerinstanzen müssen Sie dazu keinen Code in Ihren Anwendungen hinzufügen.

Wenn Sie ein gitRepo-Volume einbinden, können Sie zum Konfigurieren des Volumes drei Eigenschaften festlegen:

Eigenschaft	Erforderlich	Beschreibung
`repository`	Ja	Die vollständige URL (einschließlich `http://` bzw. `https://`) des zu klonenden Git-Repositorys
`directory`	Nein	Das Verzeichnis, in dem das Repository geklont werden soll. Der Pfad darf `..` weder enthalten noch darf er damit beginnen. Bei Angabe von `.` wird das Repository im Verzeichnis des Volumes geklont. Andernfalls wird das Git-Repository in einem Unterverzeichnis mit dem angegebenen Namen im Volumeverzeichnis geklont.
`revision`	Nein	Der Commithash der zu klonenden Version. Wird er nicht angegeben, wird die `HEAD`-Revision geklont.

Einbinden eines gitRepo-Volumes: Azure-Befehlszeilenschnittstelle

Um ein gitRepo-Volume einzubinden, wenn Sie Containerinstanzen mit der Azure-Befehlszeilenschnittstelle bereitstellen, geben Sie für den Befehl az container create die Parameter --gitrepo-url und --gitrepo-mount-path an. Sie können optional das Verzeichnis innerhalb des zu klonenden Volumes (--gitrepo-dir) und den Commithash der zu klonenden Revision (--gitrepo-revision) angeben.

Dieser Beispielbefehl klont die Microsoft-Beispielanwendung aci-helloworld in /mnt/aci-helloworld in der Containerinstanz:

az container create \
    --resource-group myResourceGroup \
    --name hellogitrepo \
    --image mcr.microsoft.com/azuredocs/aci-helloworld \
    --dns-name-label aci-demo \
    --ports 80 \
    --gitrepo-url https://github.com/Azure-Samples/aci-helloworld \
    --gitrepo-mount-path /mnt/aci-helloworld

Um zu überprüfen, ob das gitRepo-Volume eingebunden wurde, starten Sie eine Shell im Container mit az container exec, und listen Sie das Verzeichnis auf:

az container exec --resource-group myResourceGroup --name hellogitrepo --exec-command /bin/sh

/usr/src/app # ls -l /mnt/aci-helloworld/
total 16
-rw-r--r--    1 root     root           144 Apr 16 16:35 Dockerfile
-rw-r--r--    1 root     root          1162 Apr 16 16:35 LICENSE
-rw-r--r--    1 root     root          1237 Apr 16 16:35 README.md
drwxr-xr-x    2 root     root          4096 Apr 16 16:35 app

Einbinden eines gitRepo-Volumes: Ressourcen-Manager

Um ein gitRepo-Volume einzubinden, wenn Sie Containerinstanzen mit einer Azure Resource Manager-Vorlage bereitstellen, füllen Sie zuerst das Array volumes im Containergruppenabschnitt properties der Vorlage aus. Füllen Sie dann für jeden Container in der Containergruppe, in der Sie das gitRepo-Volume einbinden möchten, das Array volumeMounts im Abschnitt properties der Containerdefinition auf.

Mit der folgenden Resource Manager-Vorlage wird beispielsweise eine Containergruppe mit einem einzelnen Container erstellt. Der Container klont zwei GitHub-Repositorys, die durch die gitRepo-Volumeblöcke angegeben werden. Das zweite Volume enthält zusätzliche Eigenschaften, die ein Verzeichnis zum Klonen angeben, sowie den Commithash einer spezifischen Revision, die geklont werden soll.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "container1name": "aci-tutorial-app",
    "container1image": "mcr.microsoft.com/azuredocs/aci-helloworld"
  },
  "resources": [
    {
      "type": "Microsoft.ContainerInstance/containerGroups",
      "apiVersion": "2021-03-01",
      "name": "volume-demo-gitrepo",
      "location": "[resourceGroup().location]",
      "properties": {
        "containers": [
          {
            "name": "[variables('container1name')]",
            "properties": {
              "image": "[variables('container1image')]",
              "resources": {
                "requests": {
                  "cpu": 1,
                  "memoryInGb": 1.5
                }
              },
              "ports": [
                {
                  "port": 80
                }
              ],
              "volumeMounts": [
                {
                  "name": "gitrepo1",
                  "mountPath": "/mnt/repo1"
                },
                {
                  "name": "gitrepo2",
                  "mountPath": "/mnt/repo2"
                }
              ]
            }
          }
        ],
        "osType": "Linux",
        "ipAddress": {
          "type": "Public",
          "ports": [
            {
              "protocol": "tcp",
              "port": "80"
            }
          ]
        },
        "volumes": [
          {
            "name": "gitrepo1",
            "gitRepo": {
              "repository": "https://github.com/Azure-Samples/aci-helloworld"
            }
          },
          {
            "name": "gitrepo2",
            "gitRepo": {
              "directory": "my-custom-clone-directory",
              "repository": "https://github.com/Azure-Samples/aci-helloworld",
              "revision": "d5ccfcedc0d81f7ca5e3dbe6e5a7705b579101f1"
            }
          }
        ]
      }
    }
  ]
}

Die Verzeichnisstruktur der zwei geklonten Repositorys, die in der vorhergehenden Vorlage definiert werden, sieht wie folgt aus:

/mnt/repo1/aci-helloworld
/mnt/repo2/my-custom-clone-directory

Ein Beispiel für die Bereitstellung der Containerinstanzen mit einer Azure Resource Manager-Vorlage finden Sie unter Bereitstellen von Gruppen mit mehreren Containern in Azure Container Instances.

Authentifizierung eines privaten Git-Repositorys

Zum Einbinden eines gitRepo-Volumes für ein privates Git-Repository geben Sie Anmeldeinformationen in der Repository-URL an. Anmeldeinformationen bestehen in der Regel aus einem Benutzernamen und einem persönlichen Zugriffstoken (PAT), das bereichsbezogenen Zugriff auf das Repository gewährt.

Beispiel: Der --gitrepo-url-Parameter der Azure CLI für ein privates GitHub-Repository würde etwa wie folgt aussehen (dabei steht „gituser“ für den GitHub-Benutzernamen, und „abcdef1234fdsa4321abcdef“ ist das persönliche Zugriffstoken des Benutzers):

--gitrepo-url https://gituser:abcdef1234fdsa4321abcdef@github.com/GitUser/some-private-repository

Für ein Azure Repos Git-Repository geben Sie einen Benutzernamen (Sie können wie im folgenden Beispiel „azurereposuser“ verwenden) in Kombination mit einem gültigen PAT an:

--gitrepo-url https://azurereposuser:abcdef1234fdsa4321abcdef@dev.azure.com/your-org/_git/some-private-repository

Weitere Informationen zu persönlichen Zugriffstoken für GitHub und Azure Repos finden Sie im folgenden Leitfaden:

GitHub: Creating a personal access token for the command line (Erstellen eines persönlichen Zugriffstokens für die Befehlszeile)

Azure Repos: Create personal access tokens to authenticate access (Erstellen von persönlichen Zugriffstoken zur Authentifizierung des Zugriffs)

Nächste Schritte

Erfahren Sie, wie andere Volumetypen in Azure Container Instances bereitgestellt werden:

Teilen über