영어로 읽기

다음을 통해 공유


레지스트리 만들기

레지스트리 사용에 대한 자세한 내용은 레지스트리 사용을 참조 하세요.

개요

레지스트리는 포트 및 해당 버전의 컬렉션입니다. 사용자 고유의 레지스트리를 만들려는 경우 레지스트리 구현에는 git 레지스트리와 파일 시스템 레지스트리의 두 가지 주요 선택 항목이 있습니다.

Git 레지스트리는 간단한 git 리포지토리이며 git 리포지토리에 대한 일반 메커니즘을 통해 공개적으로 또는 비공개로 공유할 수 있습니다. 예를 들어 vcpkg 리포지토리는 git 레지스트리입니다.

파일 시스템 레지스트리는 더 많은 테스트 기반으로 설계되었습니다. 파일 시스템에 문자 그대로 사용된다는 점을 감안할 때 공유 디렉터리를 통해서만 공유할 수 있습니다. 그러나 파일 시스템 레지스트리는 디스크에 레지스트리를 가져올 수 있는 방법이 있다고 가정하고 git이 아닌 버전 제어 시스템에 보관된 레지스트리를 나타내는 방법으로 유용할 수 있습니다.

레지스트리 유형 집합은 시간이 지남에 따라 증가할 것으로 예상됩니다. 즐겨 찾는 공용 버전 제어 시스템에서 빌드된 레지스트리에 대한 지원을 원하는 경우 PR을 여는 것을 주저하지 마세요.

레지스트리의 기본 구조는 다음과 같습니다.

  • "기준선"으로 알려진 기록의 특정 시간에 "최신"으로 간주되는 버전 집합입니다.
  • 모든 포트의 모든 버전 집합 및 레지스트리에서 각 포트를 찾을 수 있는 위치입니다.

Git 레지스트리

이 설명서와 함께 팔로우하는 경우 참조할 작업 예제를 사용하는 것이 유용할 수 있습니다. 우리는 하나를 작성하고 여기에 넣어했습니다 :

Microsoft/vcpkg-docs: vcpkg 레지스트리.

모든 git 레지스트리에는 versions/baseline.json 파일이 있어야 합니다. 이 파일에는 특정 커밋의 "최신 버전" 집합이 포함되어 있습니다. 필드만 "default" 포함하는 최상위 개체로 배치됩니다. 이 필드에는 현재 최신 버전에 대한 포트 이름을 매핑하는 개체가 포함되어야 합니다.

유효한 baseline.json 예는 다음과 같습니다.

{
  "default": {
    "kitten": {
      "baseline": "2.6.2",
      "port-version": 0
    },
    "port-b": {
      "baseline": "19.00",
      "port-version": 2
    }
  }
}

디렉터리에는 versions 해당 버전이 저장되는 위치와 함께 레지스트리에 포함된 패키지 버전에 대한 모든 정보가 포함됩니다. 나머지 레지스트리는 vcpkg에 관한 한 백업 저장소 역할을 합니다. 디렉터리 내 versions 의 항목만 vcpkg에서 레지스트리를 볼 수 있는 방법을 지시하는 데 사용됩니다.

레지스트리의 각 포트는 버전 디렉터리에 <first letter of port>-/<name of port>.json있어야 합니다. 즉, 포트에 대한 kitten 정보가 있습니다 versions/k-/kitten.json. 단일 필드 "versions"만 있는 최상위 개체여야 합니다. 이 필드에는 버전 개체의 배열이 포함되어야 합니다.

  • 해당 포트의 버전입니다. 는 버전 필드 및 .를 포함하여 파일과 "port-version"정확히 같 vcpkg.json 아야 합니다.
  • "git-tree" git 트리인 필드입니다. 즉, 작성git rev-parse COMMIT-ID:path/to/port할 때 얻을 수 있는 항목입니다.

사용되지 않는 CONTROL 파일이 있는 포트의 버전 필드는 .입니다 "version-string".

경고

레지스트리의 매우 중요한 부분 중 하나는 버전을 변경해서는 안 된다는 것입니다. 이후 참조로 업데이트하는 경우 기존 버전을 제거하거나 변경해서는 안 됩니다. 항상 레지스트리를 업데이트하는 것이 안전해야 합니다.

다음은 하나의 버전이 있는 포트에 대한 kitten 유효한 버전 데이터베이스의 예입니다.

{
  "versions": [
    {
      "version": "2.6.2",
      "port-version": 0,
      "git-tree": "67d60699c271b7716279fdea5a5c6543929eb90e"
    }
  ]
}

일반적으로 포트 디렉터리를 배치하는 위치는 중요하지 않습니다. 그러나 vcpkg의 관용구는 기본 제공 vcpkg 레지스트리에서 수행하는 작업을 kitten 따르는 것입니다. 포트를 배치 ports/kitten해야 합니다.

경고

또 한 가지 유의해야 할 점은 레지스트리를 업데이트할 때 모든 이전 버전에도 액세스할 수 있어야 한다는 것입니다. 사용자가 해당 기준을 커밋 ID 설정하므로 해당 커밋 ID 항상 존재해야 하며 실제로 인출되는 HEAD 커밋에서 액세스할 수 있어야 합니다. 즉, HEAD 커밋은 이전의 모든 HEAD 커밋의 자식이어야 합니다.

기본 제공 레지스트리

기본 제공 레지스트리는 특수 Git 레지스트리로 처리됩니다. 기본 제공 레지스트리는 원격 URL에서 가져오는 대신 vcpkg 복제본의 디렉터리를 참조 $VCPKG_ROOT/.git 합니다. 현재 체크 아웃 $VCPKG_ROOT/versions 된 디렉터리를 버전 관리 정보의 원본으로 사용합니다.

새 버전 추가

포트의 새 버전을 만드는 데는 몇 가지 git 속임수가 있습니다. 가장 먼저 해야 할 일은 다음과 같이 변경하고, 필요에 따라 일반 버전 필드를 업데이트 "port-version" 한 다음, 다음을 사용하여 테스트 overlay-ports하는 것입니다.

vcpkg install kitten --overlay-ports=ports/kitten.

테스트를 완료한 후에는 디렉터리가 git의 의도 아래에 있는지 확인해야 합니다. 임시 커밋을 만들어 이 작업을 수행합니다.

> git add ports/kitten
> git commit -m 'temporary commit'

그런 다음 디렉터리의 git 트리 ID를 가져옵니다.

> git rev-parse HEAD:ports/kitten
73ad3c823ef701c37421b450a34271d6beaf7b07

그런 다음 버전 데이터베이스에 이 버전을 추가할 수 있습니다. 맨 위에 versions/k-/kitten.json버전을 2.6.3#0추가하는 것으로 가정하여 추가할 수 있습니다.

{
  "versions": [
    {
      "version": "2.6.3",
      "port-version": 0,
      "git-tree": "73ad3c823ef701c37421b450a34271d6beaf7b07"
    },
    {
      "version": "2.6.2",
      "port-version": 0,
      "git-tree": "67d60699c271b7716279fdea5a5c6543929eb90e"
    }
  ]
}

그런 다음 새 버전으로 수정할 수도 있습니다 versions/baseline.json .

{
  "default": {
    "kitten": {
      "baseline": "2.6.3",
      "port-version": 0
    },
    "port-b": {
      "baseline": "19.00",
      "port-version": 2
    }
  }
}

현재 커밋을 수정합니다.

> git commit --amend

그런 다음 멀리 공유!

파일 시스템 레지스트리

이 설명서와 함께 팔로우하는 경우 참조할 작업 예제를 사용하는 것이 유용할 수 있습니다. 우리는 하나를 작성하고 여기에 넣어했습니다 :

파일 시스템 레지스트리 예제입니다.

모든 파일 시스템 레지스트리에는 versions/baseline.json 파일이 있어야 합니다. 이 파일에는 특정 버전의 레지스트리에 대한 "최신 버전" 집합이 포함되어 있습니다. 버전 이름에서 "기준 개체"로의 맵을 포함하는 최상위 개체로 배치됩니다. 이 개체는 포트 이름을 해당 버전의 레지스트리에 대해 "최신"으로 간주되는 버전에 매핑합니다.

파일 시스템 레지스트리는 버전 관리 체계를 결정해야 합니다. 참조의 암시적 버전 관리 체계가 있는 git 레지스트리와 달리 파일 시스템 레지스트리는 여기서 버전 제어 시스템에 의존할 수 없습니다. 한 가지 가능한 옵션은 매일 릴리스를 수행하고 "버전"을 날짜로 지정하는 것입니다.

경고

초기 계획을 게시한 후에는 수정해서는 안 됩니다. 버전을 변경하거나 업데이트하려면 파일에 새 기준을 baseline.json 만들어야 합니다.

다음은 해당 버전의 날짜를 결정한 레지스트리의 유효한 baseline.json예입니다.

{
  "2021-04-16": {
    "kitten": {
      "baseline": "2.6.2",
      "port-version": 0
    },
    "port-b": {
      "baseline": "19.00",
      "port-version": 2
    }
  },
  "2021-04-15": {
    "kitten": {
      "baseline": "2.6.2",
      "port-version": 0
    },
    "port-b": {
      "baseline": "19.00",
      "port-version": 1
    }
  }
}

디렉터리에는 versions 해당 버전이 저장되는 위치와 함께 레지스트리에 포함된 패키지 버전에 대한 모든 정보가 포함됩니다. 나머지 레지스트리는 vcpkg에 관한 한 백업 저장소 역할을 합니다. 디렉터리 내 versions 의 항목만 vcpkg에서 레지스트리를 볼 수 있는 방법을 지시하는 데 사용됩니다.

레지스트리의 각 포트는 버전 디렉터리에 <first letter of port>-/<name of port>.json있어야 합니다. 즉, 포트에 대한 kitten 정보가 있습니다 versions/k-/kitten.json. 단일 필드 "versions"만 있는 최상위 개체여야 합니다. 이 필드에는 버전 개체의 배열이 포함되어야 합니다.

  • 해당 포트의 버전입니다. 는 버전 필드 및 .를 포함하여 파일과 "port-version"정확히 같 vcpkg.json 아야 합니다.
  • "path" 필드: 포트 디렉터리에 대한 레지스트리의 기준(즉, 위치하는 디렉터리)에 루트가 있는 versions 상대 디렉터리입니다. "와 같이 "$/path/to/port/dir표시되어야 합니다.

사용되지 않는 CONTROL 파일이 있는 포트의 버전 필드는 .입니다 "version-string".

일반적으로 포트 디렉터리를 배치하는 위치는 중요하지 않습니다. 그러나 vcpkg의 관용구는 기본 제공 vcpkg 레지스트리에서 수행하는 작업에 kitten 다소 밀접하게 따르는 것입니다. 버전 x.y.z 에서 포트를 배치 ports/kitten/x.y.z해야 하며, 포트 버전이 적절하게 추가됩니다(파일 이름에 사용할 수 있는 좋은 문자는 아니므로 # 사용 _).

경고

레지스트리의 매우 중요한 부분 중 하나는 버전을 변경해서는 안 된다는 것입니다. 기존 버전을 제거하거나 변경해서는 안 됩니다. 레지스트리를 변경해도 다운스트림 사용자에 대한 동작이 변경되지 않아야 합니다.

다음은 하나의 버전이 있는 포트에 대한 kitten 유효한 버전 데이터베이스의 예입니다.

{
  "versions": [
    {
      "version": "2.6.2",
      "port-version": 0,
      "path": "$/ports/kitten/2.6.2_0"
    }
  ]
}

새 버전 추가

git 레지스트리와 달리 파일 시스템 레지스트리에 새 버전을 추가하려면 대부분 많은 복사가 포함됩니다. 가장 먼저 해야 할 일은 최신 버전의 포트를 새 버전 디렉터리에 복사하고, 필요에 따라 버전 및 필드를 업데이트한 "port-version" 다음, 다음을 사용하여 테스트 overlay-ports하는 것입니다.

vcpkg install kitten --overlay-ports=ports/kitten/new-version.

테스트를 완료하면 다음 새 버전을 맨 위에 추가할 수 있습니다 versions/k-/kitten.json.

{
  "versions": [
    {
      "version": "2.6.3",
      "port-version": 0,
      "path": "$/ports/kitten/2.6.3_0"
    },
    {
      "version": "2.6.2",
      "port-version": 0,
      "path": "$/ports/kitten/2.6.2_0"
    }
  ]
}

그런 다음 새 버전으로도 수정 versions/baseline.json 하려고 합니다(기존 기준을 수정하지 마세요).

{
  "2021-04-17": {
    "kitten": {
      "baseline": "2.6.3",
      "port-version": 0
    },
    "port-b": {
      "baseline": "19.00",
      "port-version": 2
    }
  },
  "2021-04-16": {
    "kitten": {
      "baseline": "2.6.2",
      "port-version": 0
    },
    "port-b": {
      "baseline": "19.00",
      "port-version": 2
    }
  },
  "2021-04-15": {
    "kitten": {
      "baseline": "2.6.2",
      "port-version": 0
    },
    "port-b": {
      "baseline": "19.00",
      "port-version": 1
    }
  }
}

완료되었습니다!