시작하기 전에

1. IBM Cloud 콘솔에서 관리 > 계정 > 계정 설정 으로 이동하여 종량과금제 또는 구독 계정을 사용 중인지 확인하십시오.

2. 다음 IBM Cloud Identity and Access Management (IAM) 역할이 할당되었는지 확인합니다:

   • 모든 계정 관리 서비스 및 모든 IAM 서비스에 대한 관리자 권한이 있습니다.
   • 카탈로그 관리 서비스의 편집기.
   • Schematics 에 대한 관리자 서비스 액세스 역할입니다.
   • 배포 가능한 아키텍처의 특정 리소스에 필요한 기타 역할입니다. Code Engine 에 대한 클라우드 자동화는 Code Engine 서비스의 모든 리소스로 범위가 지정된 Writer 서비스 액세스 역할이 필요합니다.

   자세한 내용은 계정 관리 서비스에 액세스 권한 할당하기 및 리소스에 대한 액세스 권한 관리하기를 참조하세요.

3. Example Corp's infrastructure 라는 사용자 지정 배포 가능한 아키텍처를 만들고 Example Corp catalog 라는 비공개 카탈로그에 온보딩합니다. 이 아키텍처는 이 튜토리얼을 완료하면서 확장하게 될 아키텍처입니다.

4. 인증 방법을 설정합니다. Secrets Manager 에 저장된 API 키나 신뢰할 수 있는 프로필을 사용하여 대상 계정에 대한 배포를 승인할 수 있습니다.

   테스트 목적으로 개념 증명을 배포하시나요? 나중에 프로젝트에서 구성을 편집할 때 API 키를 만들 수 있습니다. 이렇게 하면 현재 선택한 계정에 프로젝트를 배포할 수 있는 권한이 부여됩니다.

배포 가능한 아키텍처 버전 만들기

Example Corp's infrastructure 은 이미 비공개 카탈로그에서 사용할 수 있으므로 새 버전으로 업데이트해야 합니다.

1. IBM Cloud 콘솔에서 관리 > 카탈로그 > 비공개 카탈로그를 클릭하고 비공개 카탈로그 Example Corp catalog 를 엽니다.
2. 제품 목록에서 예시 기업의 인프라를 선택합니다.
3. 버전 > 버전 추가를 클릭합니다
4. 테라폼을 배송 방법으로 선택합니다.
5. 리포지토리가 공개인지 비공개인지 지정하고 URL 소스를 제공하세요. 이 튜토리얼에서는 Example Corp's infrastructure 의 버전 0.0.1 을 온보딩하는 데 사용한 것과 동일한 소스 URL 를 사용할 수 있습니다.
6. IBM Cloud Code Engine 에서 예제 Corp AI 앱 배포를 변형으로 선택합니다.
7. 소프트웨어 버전은 0.0.2 을 입력합니다.
8. 버전 추가를 클릭합니다

여기에서 추가한 버전에 대한 세부 정보를 구성할 수 있습니다.

데이터베이스 옵션을 추가하여 예시 기업의 인프라 확장하기

버전 세부 정보를 구성할 때 서로 다른 데이터베이스를 생성하는 다른 두 개의 배포 가능한 아키텍처와 스택하여 Example Corp's infrastructure 을 확장합니다. 사용자가 IBM Cloud Databases for Elasticsearch 또는 IBM Cloud Databases for PostgreSQL 중 하나를 선택하도록 하려고 합니다. 다음 단계를 완료하십시오.

1. 3단계 - 아키텍처 확장에서 추가를 클릭합니다.

2. 제품 메뉴에서 Cloud automation for Databases for Elasticsearch 을 검색하여 선택합니다.

3. 사용자 시맨틱 버전 관리 사양( SemVer )을 참조하여 예시 코퍼레이션의 인프라와 함께 작동하는 아키텍처의 버전을 나열하세요.

   일반적으로 패치 버전에는 호환성을 깨는 변경 사항이 포함되지 않으므로, 를 사용하여 Example Corp의 SemVer 인프라와 호환되는 버전 범위를 지정할 수 있습니다. 예를 들어 ~1.32. 이렇게 하면, 예를 들어 클라우드 자동화 서비스가 패치 1.32.5 Databases for Elasticsearch 버전으로 업데이트될 경우, 해당 버전으로 Example Corps를 배포한 모든 사용자는 Elasticsearch 자신의 프로젝트를 새 버전으로 업데이트할 수 있습니다. 주요 버전 변경 시 Elasticsearch, Example Corp의 인프라스트럭처에 새 버전을 생성하여 새 버전의 가 아키텍처와 Elasticsearch 정상적으로 작동하는지 확인하십시오.

4. 표준 변형을 선택합니다.

5. 사용자에게 기본적으로 선택되는 변형인 표준을 기본 변형으로 지정합니다.

6. 아키텍처는 배포에 필요하지 않으므로 관계 메뉴에서 선택 사항 ( Example Corp's infrastructure)을 선택합니다.

7. (선택 사항) 사용자가 Example Corp's infrastructure 에서 이 아키텍처가 어떻게 작동하는지, 어떤 이점을 제공하는지 이해하는 데 도움이 되는 표시 설명을 제공합니다. 예를 들어, 다음을 입력하십시오. NoSQL database for full-text searching and querying large datasets.

8. 추가 를 클릭하십시오.

이제 Databases for Elasticsearch 에 대한 클라우드 자동화를 추가했으므로 단계를 다시 반복하되 이번에는 Cloud automation for Databases for PostgreSQL 을 검색합니다. 선택적 표시 설명의 경우 다음을 입력합니다 SQL database for relational queries and structured data.

데이터베이스를 서로 교환할 수 있게 만들기

이제 두 데이터베이스를 Example Corp's infrastructure 에 선택 사항으로 추가했으므로 서로 교환할 수 있도록 지정할 수 있습니다. 사용자는 Example Corp's infrastructure 에서 사용할 데이터베이스 옵션을 선택할 수 있습니다. 다음 단계를 완료하십시오.

1. 3단계 - 아키텍처 확장에서 Databases for Elasticsearch 에 대한 클라우드 자동화 확인란을 선택합니다.
2. Databases for PostgreSQL 에 대한 클라우드 자동화 확인란을 선택하세요.
3. 스왑 가능으로 그룹화를 클릭합니다.
4. 그룹 이름으로 Databases 을 입력하고 추가를 클릭합니다.
5. 다음 을 클릭하십시오.

사용자를 위한 변수 정의

이제 아키텍처에 몇 가지 데이터베이스 옵션을 추가했으므로 사용자에 대한 변수를 정의해야 합니다. 이렇게 하면 아키텍처의 입력이 서로 연결되므로 사용자가 배포를 위해 Example Corp's infrastructure 을 쉽게 구성할 수 있습니다.

1. 4단계 - 배포 세부 정보 구성에서 변수 정의를 클릭합니다.

   변수 정의 창이 표시되며, 선택된 Databases for Elasticsearch 클라우드 자동화 아키텍처의 입력 및 출력에 접근할 수 있습니다. 여기에서 참조를 추가하거나 사용자가 구성할 수 있도록 Example Corp's infrastructure 로 입력을 이동할 수 있습니다.

2. Example Corp's infrastructure 생성 당시에는 지역이 미국으로 제한되어 있었습니다. Databases for Elasticsearch 에 대한 클라우드 자동화가 Example Corp's infrastructure 과 동일한 리전을 사용하도록 하려면 다음 단계를 완료하여 참조를 추가하여 서로 연결하세요:

   1. Databases for Elasticsearch 에 대한 클라우드 자동화를 위한 필수 입력 창에서 변수 참조 아이콘 을 선택하여 region 입력합니다.
   2. 그런 다음 변수 이름 메뉴에서 지역을 선택합니다.
   3. 추가 를 클릭하십시오. 사용자가 Example Corp's infrastructure 에서 region 입력을 구성하면 Databases for Elasticsearch 에 대한 클라우드 자동화는 사용자가 제공한 값을 입력으로 사용합니다.

3. Example Corp's infrastructure 에는 prefix 입력도 포함되어 있으므로 Databases for Elasticsearch 에 대한 클라우드 자동화의 prefix 입력에 대해서도 동일한 단계를 완료합니다:

   1. prefix 입력에 대해 변수 참조 아이콘 을 선택합니다.
   2. 그런 다음 변수 이름 메뉴에서 접두사를 선택합니다.
   3. 추가 를 클릭하십시오.

4. Example Corp's infrastructure 에는 existing_resource_group_name 에 대한 입력이 포함되어 있으므로 Databases for Elasticsearch 에 대한 클라우드 자동화에 동일한 리소스 그룹을 사용할 수 있습니다:

   1. resource_group_name 입력에 대해 변수 참조 아이콘 을 선택합니다.
   2. 그런 다음 변수 이름 메뉴에서 기존_자원_그룹_이름을 선택합니다.
   3. 추가 를 클릭하십시오.

5. 사용자에게 아키텍처에 대한 기존 리소스 그룹이 필요함을 나타내려면 use_existing_resource_group 의 기본값을 true로 설정하세요.

6. 개발 환경의 설정을 간소화하고 비용을 줄이려면 다음 단계를 완료하여 키 암호화 요구 사항을 제거하세요:

   1. existing_kms_instance_crn 의 기본값을 __NULL__ 으로 설정합니다.
   2. 선택적 입력을 클릭합니다.
   3. use_ibm_owned_encryption_key 의 기본값을 true로 설정합니다.
   4. plan 의 기본값을 enterprise 으로 설정합니다.
   5. member_cpu_count 의 기본값을 2 으로 설정합니다.
   6. member_host_flavor 의 기본값을 multitenant 으로 설정합니다.

이제 Databases for Elasticsearch 에 대한 클라우드 자동화에 대한 변수를 정의했으므로 포함시킨 다른 데이터베이스 옵션에 대한 변수를 정의해야 합니다: Databases for PostgreSQL 에 대한 클라우드 자동화를 정의해야 합니다. 다음 단계를 완료하십시오.

1. 변수 정의 창에서 아키텍처 메뉴를 사용하여 Databases for Elasticsearch 용 클라우드 자동화 에서 Databases for PostgreSQL 용 클라우드 자동화로 전환합니다.
2. 필수 입력을 클릭하고 existing_kms_instance_crn 의 기본값을 __NULL__ 으로 설정하여 키 암호화 요구 사항을 제거합니다.
3. 이 아키텍처의 다른 세 가지 필수 입력은 모두 Example Corp's infrastructure 에서 이미 사용할 수 있는 입력을 참조할 수 있습니다. 이러한 입력에 대한 참조를 추가하려면 다음 단계를 완료하세요:
   1. resource_group_name 에서 변수 참조 아이콘 을 선택한 다음 변수 이름 메뉴에서 기존_자원_그룹_이름 을 선택합니다. 추가를 클릭하면 Databases for PostgreSQL 에 대한 클라우드 자동화 내의 resource_group_name 입력이 사용자가 제공한 예시 회사의 인프라에서 existing_resource_group_name 값을 참조합니다.
   2. prefix 에서 변수 참조 아이콘 을 선택하고 변수 이름 메뉴에서 접두사 을 선택한 후 추가 을 클릭합니다.
   3. region 에서 변수 참조 아이콘 을 선택하고 변수 이름 메뉴에서 지역 을 선택한 후 추가 을 클릭합니다.
4. 선택적 입력을 클릭합니다.
5. 사용자에게 아키텍처에 대한 기존 리소스 그룹이 필요함을 나타내려면 use_existing_resource_group 의 기본값을 true로 설정하세요.
6. use_ibm_owned_encryption_key 의 기본값을 true로 설정합니다.
7. 저장 을 클릭하십시오.

사용자에게 변경 사항 전달

최신 버전( Example Corp's infrastructure )에는 획기적인 변경 사항은 포함되어 있지 않지만 사용자가 알아야 할 새로운 기능이 포함되어 있습니다. 변경 공지를 추가하여 Example Corp's infrastructure 에서 사용할 수 있는 새로운 데이터베이스 옵션에 대해 사용자에게 알립니다. 다음 단계를 완료하십시오.

1. 6단계 - 변경 공지 추가에서 새 기능 추가를 클릭합니다.
2. 제목 필드에 Database options added to Example Corp's infrastructure 을 입력합니다.
3. 설명에 다음을 입력합니다 Version 0.0.2 includes two optional databases that you can choose to add. You can either use Cloud automation for Databases for Elasticsearch, or Cloud automation for Databases for PostgreSQL.
4. 저장 을 클릭하십시오.

작업 메뉴에서 매니페스트 생성을 선택하여 최신 변경 사항을 다운로드합니다. 파일을 다운로드하여 소스 코드 리포지토리에 추가하여 변경 사항을 다음 릴리스에 적용하는 것이 가장 좋습니다.

프로젝트에서 배포하여 아키텍처 검증하기

이제 0.0.2 버전( Example Corp's infrastructure )을 비공개 카탈로그에서 초안으로 사용할 수 있습니다. 비공개 카탈로그에 액세스할 수 있는 모든 사용자가 배포할 수 있습니다. 데이터베이스 옵션이 Example Corp's infrastructure 에서 작동하는지 확인하려면 프로젝트에서 두 번 배포하세요. 하나의 배포에는 Elasticsearch 을 포함시킵니다. 그리고 다른 배포의 경우 PostgreSQL 을 포함합니다. 아키텍처를 두 번 배포하여 두 데이터베이스 옵션이 모두 Example Corp's infrastructure 에서 의도한 대로 작동하는지 확인합니다.

Example Corp's infrastructure 을 기업에서 공유하려면 먼저 비공개 카탈로그에 온보딩할 때 버전을 확인해야 합니다. 현재 카탈로그의 버전 유효성 검 사는 사용자가 직접 스택한 아키텍처의 유효성을 검사하지 않습니다. Example Corp's infrastructure 이 비공개 카탈로그에서 초안 상태일 때 프로젝트에서 아키텍처를 배포하면 포함된 아키텍처가 Example Corp's infrastructure 에서 제대로 작동하는지 확인할 수 있습니다.

다음 단계

최신 버전을 계속 온보딩하세요. Example Corp's infrastructure. 완료되면 배포 가능한 아키텍처의 새 버전을 사용자가 사용할 수 있습니다. 프로젝트에 새 버전을 추가할 때 Databases for Elasticsearch 또는 Databases for PostgreSQL 에 대한 클라우드 자동화를 포함하여 사용자 지정할 수 있습니다.

사용자가 이미 이전 버전의 Example Corp's infrastructure 을 배포한 경우 프로젝트에 주의 필요 위젯이 표시되어 아키텍처를 최신 버전으로 업데이트하라는 메시지가 표시됩니다.