모델 및 패키지 배포 단위

이 페이지에서는 SaaS 제품의 배포 단위를 모델링하고 패키징하는 방법을 설명합니다. SaaS 런타임에서 배포 단위를 단위 종류라고 합니다.

독립적으로 관리하려는 SaaS 제품의 각 구성요소에 대해 하나의 단위 종류를 만듭니다. 자세한 내용은 다음 섹션 SaaS 제품의 모델 결정을 참고하세요.

원하는 경우 전체 SaaS 제품에 단일 단위 종류를 사용하여 SaaS 제품을 만들 수 있습니다.

단위 종류는 청사진에 의해 정의되며, 청사진은 OCI 이미지로 패키징된 Terraform 구성입니다. 단위 종류를 만들기 전에 각 단위 종류에 대해 청사진을 만들어야 합니다. 청사진 만들기에 대한 자세한 내용은 청사진 만들기 및 업로드를 참고하세요.

시작하기 전에

  1. SaaS 애플리케이션에 대해 SaaS 제품을 정의했는지 확인합니다.
  2. Artifact Registry 저장소를 만들었는지 확인합니다.
  3. 필요한 권한이 있는 서비스 계정이 있는지 확인합니다. 자세한 내용은 SaaS 런타임 서비스 계정을 참고하세요.
  4. 만들려는 각 단위 종류에 대해 Terraform 구성이 있고 청사진을 준비했는지 확인합니다. 자세한 내용은 다음 섹션 SaaS 제품의 모델 결정을 참고하세요.

SaaS 제품의 모델 결정

SaaS 제품을 모델링하려면 만들 단위 종류의 수와 이러한 단위 종류 간의 관계를 결정해야 합니다.

예를 들어 VM과 같은 인프라용 단위 종류 하나와 인프라에 배포된 애플리케이션용 단위 종류 하나를 만들 수 있습니다. 원하는 경우 전체 SaaS 제품에 단일 단위 종류를 사용하여 SaaS 제품을 만들 수 있습니다.

단위 종류를 사용하여 SaaS 제품을 모델링하는 방법을 결정하려면 다음을 고려하세요.

  • SaaS 제품의 구성요소 간 종속 항목을 검토합니다. 예를 들어 SaaS 제품에 공유 Kubernetes 클러스터에 배포된 애플리케이션이 포함된 경우 단위 종류를 사용하여 이 공유 클러스터를 모델링하는 것이 좋습니다.
  • SaaS 제품의 구성요소 출시 및 유지관리 주기를 고려합니다. 인프라와 같이 함께 관리되는 구성요소가 있는 경우 하나의 단위 종류로 이러한 구성요소를 모델링하는 것이 좋습니다.

이 모델을 결정한 후에는 각 단위 종류의 청사진을 만들어야 합니다. 이렇게 하려면 다음을 수행해야 합니다.

  1. 이 단위 종류에 연결할 Terraform 구성을 식별합니다. 필요한 Terraform 구성에 관한 자세한 내용은 SaaS 런타임의 청사진을 참고하세요.
  2. Terraform 구성이 OCI 이미지로 패키징되어 Artifact Registry로 푸시되었거나 zip 보관 파일 또는 Git 저장소에 있는지 확인합니다. 자세한 내용은 청사진 만들기 및 업로드를 참고하세요.

각 단위 종류의 청사진이 있으면 이 페이지의 안내에 따라 단위 종류를 만들 수 있습니다.

단위 종류 만들기

다음과 같은 방법으로 제공되는 Terraform 구성을 사용하여 단위 종류를 만들 수 있습니다.

  • ZIP 파일
  • Git 저장소에 있습니다.
  • OCI 이미지로 패키징됩니다.

zip 보관 파일을 사용하여 단위 종류 만들기

zip 보관 파일에 있는 Terraform 구성을 사용하여 단위 종류를 만들려면 다음 안내를 완료하세요.

ZIP 보관 파일 준비에 대한 자세한 내용은 ZIP 보관 파일 업로드를 참고하세요.

단위 종류를 만들려면 다음 단계를 따르세요.

  1. 콘솔에서 SaaS 런타임 > 단위 종류로 이동합니다.

    단위 종류로 이동

  2. 만들기를 선택합니다.

  3. 청사진 만들기에서 업로드를 선택하여 Terraform 구성이 포함된 zip 보관 파일을 업로드합니다.

    1. 찾아보기를 클릭하고 이 단위 종류에 속하는 리소스 또는 애플리케이션을 정의하는 Terraform 구성이 포함된 zip 보관 파일을 찾습니다.

    2. 다음: 청사진 구성을 클릭합니다.

  4. 스토어 청사진 페이지에서 다음을 수행합니다.

    1. Artifact Registry에서 저장소 선택의 경우 찾아보기를 클릭하고 만든 저장소를 선택합니다.

    2. 아티팩트 이미지 이름에 OCI 이미지의 이름을 입력합니다.

    3. Infrastructure Manager Terraform 버전의 경우 배포에 사용할 Terraform 버전을 선택합니다. 지원되는 Terraform 버전 목록은 지원되는 Terraform 버전을 참고하세요.

    4. Cloud Build 서비스 계정에서 이미지를 빌드할 수 있는 권한이 있는 서비스 계정을 선택합니다. 자세한 내용은 아티팩트 생성 서비스 계정을 참고하세요.

    5. 다음: 단위 종류 세부정보를 클릭합니다.

  5. 단위 종류 속성 구성 페이지에서 다음을 수행합니다.

    1. 단위 종류 이름에 단위 종류의 이름을 입력합니다. 이름에는 소문자, 숫자 또는 하이픈만 포함해야 합니다.

    2. SaaS 제품에서 이 단위 종류와 연결할 SaaS 제품을 선택합니다.

    3. 종속 항목의 경우:

      • SaaS 제품에 대해 만드는 첫 번째 또는 유일한 단위 종류인 경우 종속 항목을 추가하지 마세요.

      • 이 단위 종류에 종속된 다른 단위 종류를 만든 경우 종속 항목 추가를 선택합니다.

        1. 단위 종류의 경우 만들려는 단위 종류에 종속된 기존 단위 종류를 선택합니다.

        2. 별칭에 입력 변수 매핑에 사용할 수 있는 이름을 입력합니다.

        3. 완료를 클릭합니다.

        4. 변수 매핑을 정의하려면 다음 단계를 따르세요. 변수 매핑에 대한 자세한 내용은 변수 매핑을 참고하세요.

          1. 입력 및 출력 변수 매핑 정의를 선택합니다.

          2. 입력 변수 매핑의 경우:

            1. 입력 변수 매핑 추가를 선택합니다.
            2. 변수에 입력 변수의 이름을 입력합니다.
            3. 매핑 유형에서 다음을 선택합니다.
              • From: 다른 단위 종류에서 매핑합니다.
              • To를 사용하여 다른 단위 종류에 매핑합니다.
            4. 종속 항목에서 변수를 매핑할 기존 단위 종류를 선택합니다.
            5. 출력 변수에 출력 변수의 이름을 입력합니다.
            6. 완료를 선택합니다.

          3. 다른 입력 변수를 추가하려면 입력 변수 매핑 추가를 선택하고 단계를 반복합니다.

          4. 출력 변수 매핑을 추가하려면 다음 단계를 따르세요.

            1. 출력 변수 매핑 탭을 선택합니다.
            2. 출력 변수 매핑 추가를 선택하고 입력 변수 매핑에 사용한 단계를 반복합니다.

  6. 다음: 출시 구성을 클릭합니다.

  7. 버전 이름에 버전 이름을 입력합니다.

  8. 선택사항: 배포하는 리소스에 라벨을 추가합니다. 라벨에 대한 자세한 내용은 라벨 개요를 참고하세요.

    라벨을 추가하려면 다음 단계를 따르세요.

    1. 라벨에서 라벨 추가를 선택합니다.

    2. 키 1 및 값 1에 원하는 키-값 쌍을 입력합니다.

    3. 추가하려는 라벨마다 이 단계를 반복합니다.

  9. 만들기를 클릭합니다.

이제 단위 종류가 생성되었습니다. 다른 단위 종류를 만들려면 동일한 단계를 반복하고 이 다음 단위 종류의 Terraform 구성이 포함된 zip 파일을 사용합니다.

SaaS 제품에 필요한 모든 단위 종류를 만든 경우 단위 인스턴스를 배포할 수 있습니다.

Git 저장소를 사용하여 단위 종류 만들기

Git 저장소에 있는 Terraform 구성을 사용하여 단위 종류를 만들려면 다음 안내를 완료하세요.

Terraform 파일에 Git 저장소를 사용하는 방법에 관한 자세한 내용은 Git 저장소에 연결을 참고하세요.

  1. 콘솔에서 SaaS 런타임 > 단위 종류로 이동합니다.

    단위 종류로 이동

  2. 만들기를 선택합니다.

  3. 청사진 만들기에서 외부 저장소 연결을 선택합니다.

  4. 저장소에서 Terraform 구성이 있는 Git 저장소를 선택합니다.

    1. Git 저장소가 연결되어 있으면 목록에서 선택합니다.

    2. 저장소가 연결되어 있지 않으면 새 저장소 연결을 클릭하여 Developer Connect를 사용하여 저장소를 연결합니다.

      1. 새 연결 만들기를 선택합니다.

      2. 리전에서 Developer Connect 연결의 리전을 선택합니다. Artifact Registry 저장소에 사용된 리전과 동일한 리전을 사용하는 것이 좋습니다.

      3. 선택사항: KMS 키의 경우 암호화에 사용할 KMS 키를 지정할 수 있습니다.

      4. 브랜치에서 이 단위 종류와 연결할 Terraform 구성이 있는 Git 브랜치를 지정합니다.

  5. 스토어 청사진 페이지에서 다음을 수행합니다.

    1. Artifact Registry에서 저장소 선택의 경우 찾아보기를 클릭하고 SaaS 제품에 사용 중인 Artifact Registry 저장소를 선택합니다.

    2. 아티팩트 이미지 이름에 OCI 이미지의 이름을 입력합니다.

    3. Infrastructure Manager Terraform 버전의 경우 배포에 사용할 Terraform 버전을 선택합니다. 지원되는 Terraform 버전 목록은 지원되는 Terraform 버전을 참고하세요.

    4. Cloud Build 서비스 계정에서 이미지를 빌드할 수 있는 권한이 있는 서비스 계정을 선택합니다. 자세한 내용은 아티팩트 생성 서비스 계정을 참고하세요.

    5. 다음: 단위 종류 세부정보를 클릭합니다.

  6. 단위 종류 속성 구성 페이지에서 다음을 수행합니다.

    1. 단위 종류 이름에 단위 종류의 이름을 입력합니다. 이름에는 소문자, 숫자 또는 하이픈만 포함해야 합니다.

    2. SaaS 제품에서 이 단위 종류와 연결할 SaaS 제품을 선택합니다.

    3. 종속 항목의 경우:

      • SaaS 제품에 대해 만드는 첫 번째 또는 유일한 단위 종류인 경우 종속 항목을 추가하지 마세요.

      • 이 단위 종류에 종속된 다른 단위 종류를 만든 경우 종속 항목 추가를 선택합니다.

        1. 단위 종류의 경우 만들려는 단위 종류에 종속된 기존 단위 종류를 선택합니다.

        2. 별칭에 입력 변수 매핑에 사용할 수 있는 이름을 입력합니다.

        3. 완료를 클릭합니다.

        4. 변수 매핑을 정의하려면 다음 단계를 따르세요. 변수 매핑에 대한 자세한 내용은 변수 매핑을 참고하세요.

          1. 입력 및 출력 변수 매핑 정의를 선택합니다.

          2. 입력 변수 매핑의 경우:

            1. 입력 변수 매핑 추가를 선택합니다.
            2. 변수에 입력 변수의 이름을 입력합니다.
            3. 매핑 유형에서 다음을 선택합니다.
              • From: 다른 단위 종류에서 매핑합니다.
              • To를 사용하여 다른 단위 종류에 매핑합니다.
            4. 종속 항목에서 변수를 매핑할 기존 단위 종류를 선택합니다.
            5. 출력 변수에 출력 변수의 이름을 입력합니다.
            6. 완료를 선택합니다.

          3. 다른 입력 변수를 추가하려면 입력 변수 매핑 추가를 선택하고 단계를 반복합니다.

          4. 출력 변수 매핑을 추가하려면 다음 단계를 따르세요.

            1. 출력 변수 매핑 탭을 선택합니다.
            2. 출력 변수 매핑 추가를 선택하고 입력 변수 매핑에 사용한 단계를 반복합니다.

  7. 다음: 출시 구성을 클릭합니다.

  8. 버전 이름에 버전 이름을 입력합니다.

  9. 선택사항: 배포하는 리소스에 라벨을 추가합니다. 라벨에 대한 자세한 내용은 라벨 개요를 참고하세요.

    라벨을 추가하려면 다음 단계를 따르세요.

    1. 라벨에서 라벨 추가를 선택합니다.

    2. 키 1 및 값 1에 원하는 키-값 쌍을 입력합니다.

    3. 추가하려는 라벨마다 이 단계를 반복합니다.

  10. 만들기를 클릭합니다.

이제 단위 종류가 생성되었습니다. 다른 단위 종류를 만들려면 동일한 단계를 반복하고 이 다음 단위 종류의 Terraform 구성이 포함된 Git 저장소를 사용합니다.

SaaS 제품에 필요한 모든 단위 종류를 만든 경우 단위 인스턴스를 배포할 수 있습니다.

기존 이미지를 사용하여 단위 종류 만들기

OCI 이미지인 기존 청사진을 사용하여 단위 종류를 만들려면 다음 안내를 따르세요.

OCI 이미지 빌드에 대한 자세한 내용은 다음을 참고하세요.

  1. 콘솔에서 SaaS 런타임 > 단위 종류로 이동합니다.

    단위 종류로 이동

  2. 만들기를 선택합니다.

  3. 청사진 만들기에서 Artifact Registry에서 기존 이미지 선택을 선택합니다.

  4. 다음: 청사진 구성을 클릭합니다.

  5. 스토어 청사진 페이지에서 다음을 수행합니다.

    1. Artifact Registry에서 기존 청사진 선택 또는 입력의 경우 다음 단계를 따르세요.

      1. 탐색을 클릭합니다.

      2. Terraform 구성이 포함된 이미지로 이동합니다.

      3. 선택을 클릭합니다.

    2. 다음: 단위 종류 세부정보를 클릭합니다.

  6. 단위 종류 속성 구성 페이지에서 다음을 수행합니다.

    1. 단위 종류 이름에 단위 종류의 이름을 입력합니다. 이름에는 소문자, 숫자 또는 하이픈만 포함해야 합니다.

    2. SaaS 제품에서 이 단위 종류와 연결할 SaaS 제품을 선택합니다.

    3. 종속 항목의 경우:

      • SaaS 제품에 대해 만드는 첫 번째 또는 유일한 단위 종류인 경우 종속 항목을 추가하지 마세요.

      • 이 단위 종류에 종속된 다른 단위 종류를 만든 경우 종속 항목 추가를 선택합니다.

        1. 단위 종류의 경우 만들려는 단위 종류에 종속된 기존 단위 종류를 선택합니다.

        2. 별칭에 입력 변수 매핑에 사용할 수 있는 이름을 입력합니다.

        3. 완료를 클릭합니다.

        4. 변수 매핑을 정의하려면 다음 단계를 따르세요. 변수 매핑에 대한 자세한 내용은 변수 매핑을 참고하세요.

          1. 입력 및 출력 변수 매핑 정의를 선택합니다.

          2. 입력 변수 매핑의 경우:

            1. 입력 변수 매핑 추가를 선택합니다.
            2. 변수에 입력 변수의 이름을 입력합니다.
            3. 매핑 유형에서 다음을 선택합니다.
              • From: 다른 단위 종류에서 매핑합니다.
              • To를 사용하여 다른 단위 종류에 매핑합니다.
            4. 종속 항목에서 변수를 매핑할 기존 단위 종류를 선택합니다.
            5. 출력 변수에 출력 변수의 이름을 입력합니다.
            6. 완료를 선택합니다.

          3. 다른 입력 변수를 추가하려면 입력 변수 매핑 추가를 선택하고 단계를 반복합니다.

          4. 출력 변수 매핑을 추가하려면 다음 단계를 따르세요.

            1. 출력 변수 매핑 탭을 선택합니다.
            2. 출력 변수 매핑 추가를 선택하고 입력 변수 매핑에 사용한 단계를 반복합니다.

  7. 다음: 출시 구성을 클릭합니다.

  8. 버전 이름에 버전 이름을 입력합니다.

  9. 선택사항: 배포하는 리소스에 라벨을 추가합니다. 라벨에 대한 자세한 내용은 라벨 개요를 참고하세요.

    라벨을 추가하려면 다음 단계를 따르세요.

    1. 라벨에서 라벨 추가를 선택합니다.

    2. 키 1 및 값 1에 원하는 키-값 쌍을 입력합니다.

    3. 추가하려는 라벨마다 이 단계를 반복합니다.

  10. 만들기를 클릭합니다.

이제 단위 종류가 생성되었습니다. 다른 단위 종류를 만들려면 동일한 단계를 반복하고 이 다음 단위 종류의 Terraform 구성이 포함된 OCI 이미지를 사용합니다.

SaaS 제품에 필요한 모든 단위 종류를 만든 경우 단위 인스턴스를 배포할 수 있습니다.

다음 단계