Image Builder의 의미 체계 버전 관리 - EC2 Image Builder
버전 참조 사용사용 가능한 버전 참조 패턴버전 참조를 반환하는 리소스

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Image Builder의 의미 체계 버전 관리

Image Builder는 의미 체계 버전 관리를 사용하여 리소스를 구성하고 리소스가 고유한 ID를 갖도록 합니다. 의미 체계 버전에는 다음과 같은 4가지 노드가 있습니다.

<major>.<minor>.<patch>/<build>

처음 3개의 값을 할당하고 모든 값을 필터링할 수 있습니다.

의미 체계 버전 관리는 다음과 같이 각 객체의 Amazon 리소스 이름(ARN)에 해당 객체에 적용되는 수준으로 포함됩니다.

  1. 버전이 없는 ARN과 이름 ARN은 어떤 노드에도 특정 값을 포함하지 않습니다. 노드는 완전히 제외되거나 와일드카드로 지정됩니다(예: x.x.x).

  2. 버전 ARN에는 처음 세 개의 노드, <major>.<minor>.<patch>만 있습니다

  3. 빌드 버전 ARN에는 노드 4개가 모두 있으며 객체의 특정 버전에 대한 특정 빌드를 가리킵니다.

할당: 처음 세 노드의 경우 각 노드에 대해 상한이 2^30-1 또는 1073741823인 양의 정수 값 또는 0을 할당할 수 있습니다. Image Builder는 자동으로 4번째 노드에 빌드 번호를 할당합니다.

패턴: 할당할 수 있는 노드에 대한 할당 요구 사항을 준수하는 모든 숫자 패턴을 사용할 수 있습니다. 예를 들어 1.0.0과 같은 소프트웨어 버전 패턴이나 2021.01.01과 같은 날짜를 선택할 수 있습니다.

필터링: 의미 체계 버전 관리를 사용하면 레시피에 대한 기본 이미지 또는 구성 요소를 선택할 때 와일드카드(x)를 사용하여 최신 버전 또는 노드를 지정할 수 있습니다. 임의의 노드에서 와일드카드를 사용하는 경우 첫 번째 와일드카드 오른쪽에 있는 모든 노드도 와일드카드여야 합니다.

예를 들어 2.2.4, 1.7.8, 1.6.8의 최신 버전에서 와일드카드를 사용하여 버전을 선택하면 다음과 같은 결과가 나타납니다.

  • x.x.x = 2.2.4

  • 1.x.x = 1.7.8

  • 1.6.x = 1.6.8

  • x.2.x 값은 유효하지 않아 오류가 발생합니다.

  • 1.x.8 값은 유효하지 않아 오류가 발생합니다.

버전 참조 사용

버전 참조는 생성하거나 검색한 리소스의 의미 체계 버전을 기반으로 와일드카드 패턴을 통합하는 ready-to-use 수 있는 ARN 문자열입니다. Image Builder는 사용자 지정 코드를 작성하여 ARNs을 구문 분석하고 와일드카드를 삽입하는 대신이 작업을 수행합니다.

Image Builder 리소스를 생성하거나 검색하면 Image Builder는 latestVersionReferences 객체에 와일드카드 버전 패턴이 포함된 사전 구성된 ARNs을 자동으로 제공합니다. 따라서 와일드카드 버전 관리 패턴을 사용하여 리소스를 참조하려는 경우 ARNs 수동으로 구문 분석하고 재구성할 필요가 없습니다.

예를 들어 버전 로 구성 요소를 생성하면 1.2.3Image Builder는 다음을 반환합니다.


{
    "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.3/1",
    "latestVersionReferences": {
        "latestVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/x.x.x",
        "latestMajorVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.x.x",
        "latestMinorVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.x",
        "latestPatchVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.3"
    }
}

사용 가능한 버전 참조 패턴

latestVersionReferences 객체에는 네 가지 ARN 패턴이 있습니다.

  • latestVersionArn(x.x.x) - 항상 절대 최신 버전으로 확인됩니다.

  • atestMajorVersionArn(1.x.x) - 메이저 버전 내의 최신 마이너 및 패치 버전으로 해결됩니다.

  • latestMinorVersionArn(1.2.x) - 특정 마이너 버전 내의 최신 패치 버전으로 해결됩니다.

  • latestPatchVersionArn(1.2.3) - 특정 의미 체계 버전을 참조하고 여러 빌드 버전을 지원하는 리소스의 최신 빌드 버전으로 확인합니다.

버전 참조를 반환하는 리소스

버전 참조는 버전이 지정된 모든 Image Builder 리소스에 대해 Create 및 Get APIs에서 반환됩니다.

  • 구성 요소 - CreateComponent, GetComponent

  • 이미지 레시피 - CreateImageRecipe, GetImageRecipe

  • 컨테이너 레시피 - CreateContainerRecipe, GetContainerRecipe

  • 이미지 - CreateImage, GetImage

  • 워크플로 - CreateWorkflow, GetWorkflow

참고: Image Builder 관리형 워크플로의 경우 Image Builder에서는 항상 최신 버전의 Image Builder 관리형 워크플로를 사용해야 하므로 만 반환latestVersionArn (x.x.x)됩니다.