Azure Container Instances에서 gitRepo 볼륨 탑재

gitRepo 볼륨을 탑재하여 컨테이너 인스턴스에 Git 리포지토리를 복제하는 방법을 알아봅니다.

참고 항목

gitRepo 볼륨 탑재는 현재 Linux 컨테이너로 제한됩니다. Windows 컨테이너에도 모든 기능을 제공하려고 작업 중이며 현재 플랫폼의 차이점은 개요에서 찾아볼 수 있습니다.

gitRepo 볼륨

gitRepo 볼륨은 디렉터리를 탑재하고 컨테이너 만드는 동안 지정된 Git 리포지토리를 디렉터리에 복제합니다. 컨테이너 인스턴스의 gitRepo 볼륨을 사용하면 애플리케이션에서 코드를 추가하지 않아도 됩니다.

gitRepo 볼륨을 탑재할 때 세 개의 속성을 설정하여 볼륨을 구성할 수 있습니다.

속성	필수	설명
repository	예	복제할 Git 리포지토리의 http:// 또는 https://를 포함한 전체 URL입니다.
directory	아니요	리포지토리를 복제해야 하는 디렉터리입니다. 경로는 ".."을 포함하거나 이것으로 시작되지 않아야 합니다. "."을 지정하면 리포지토리가 볼륨의 디렉터리에 복제됩니다. 그렇지 않을 경우 Git 리포지토리가 볼륨 디렉터리 내 지정된 이름의 하위 디렉터리에 복제됩니다.
revision	아니요	복제될 수정 내용의 커밋 해시입니다. 지정하지 않으면 HEAD 수정 내용이 복제됩니다.

gitRepo 볼륨 탑재: Azure CLI

Azure CLI로 컨테이너 인스턴스를 배포할 때 gitRepo 볼륨을 탑재하려면 --gitrepo-url 및 --gitrepo-mount-path 매개 변수를 az container create 명령에 제공합니다. 선택적으로 복제할 볼륨 내 디렉터리(--gitrepo-dir)와 복제된 수정 작업의 커밋 해시(--gitrepo-revision)를 지정할 수 있습니다.

이 예제 명령은 Microsoft aci-helloworld 샘플 애플리케이션을 컨테이너 인스턴스의 /mnt/aci-helloworld에 복제합니다.

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

gitRepo 볼륨이 탑재되었는지 확인하려면 az container exec로 컨테이너에서 셸을 시작하고 디렉터리를 나열합니다.

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

gitRepo 볼륨 탑재: Resource Manager

Azure Resource Manager 템플릿을 사용하여 gitRepo 볼륨을 탑재하려면 먼저 템플릿의 컨테이너 그룹 properties 섹션에서 volumes 배열을 입력합니다. 다음으로 gitRepo 볼륨을 탑재하려는 컨테이너 그룹에 있는 각 컨테이너의 경우 컨테이너 정의의 properties 섹션에서 volumeMounts 배열을 채웁니다.

예를 들어 다음과 같은 Resource Manager 템플릿은 단일 컨테이너로 구성된 컨테이너 그룹을 만듭니다. 컨테이너는 gitRepo 볼륨 블록으로 지정된 GitHub 리포지토리 두 개를 복제합니다. 두 번째 볼륨에는 복제할 디렉터리를 지정하는 추가 속성과 복제할 특정 수정 내용의 커밋 해시가 포함됩니다.

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

이전 템플릿에 정의된 두 복제 리포지토리의 결과 디렉터리 구조는 다음과 같습니다.

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

Azure Resource Manager 템플릿을 사용하는 컨테이너 인스턴스 배포의 예제를 보려면 Azure Container Instances에서 다중 컨테이너 그룹 배포를 참조하세요.

프라이빗 Git 리포지토리 인증

프라이빗 Git 리포지토리에 대한 gitRepo 볼륨을 탑재하려면 리포지토리 URL에서 자격 증명을 지정합니다. 일반적으로 자격 증명은 사용자 이름의 형식이며 리포지토리에 대한 범위가 지정된 액세스 권한을 부여하는 PAT(개인용 액세스 토큰)입니다.

예를 들어 프라이빗 GitHub 리포지토리에 대한 Azure CLI --gitrepo-url 매개 변수는 다음과 비슷하게 표시됩니다(여기에서 "gituser"는 GitHub 사용자 이름이며, "abcdef1234fdsa4321abcdef"는 사용자의 개인용 액세스 토큰임).

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

Azure Repos Git 리포지토리의 경우 유효한 PAT와 조합해서 사용자 이름을 지정합니다(다음 예제와 같이 “azurereposuser”를 사용할 수 있음).

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

GitHub 및 Azure Repos의 개인용 액세스 토큰에 대한 자세한 내용은 다음을 참조하세요.

GitHub: 명령줄에 대한 개인용 액세스 토큰 만들기

Azure Repos: 액세스 인증을 위한 개인용 액세스 토큰 만들기

다음 단계

Azure Container Instances에서 다른 볼륨 유형을 탑재하는 방법을 알아봅니다.

• Azure Container Instances에서 Azure 파일 공유 탑재
• Azure Container Instances에서 emptyDir 볼륨 탑재
• Azure Container Instances에서 비밀 볼륨 탑재