Schematics 작업공간에서 프로젝트로 자원 이동

IBM Cloud® Schematics 작업공간 에서 IBM Cloud® 프로젝트로 자원을 이동하여 엔터프라이즈 아키텍처의 라이프사이클을 관리할 수 있습니다. Terraform및 배치 가능한 아키텍처를 사용하기 위해 Schematics 작업공간을 사용할 수 있지만 프로젝트를 사용하여 전체 라이프사이클을 규모에 맞게 관리할 수 있습니다. 이 태스크를 완료하면 개인용 카탈로그에 배치 가능한 아키텍처 타일이 있으며 프로젝트에서 배치 가능한 아키텍처의 라이프사이클을 관리할 수 있습니다.

이 프로세스 중에 CLI 명령 ibmcloud catalog utility create-product-from-workspace 및 ibmcloud project config-create 를 사용하여 함께 링크된 카탈로그 및 프로젝트를 작성한 후 Schematics 작업공간 리소스를 프로젝트로 이동할 수 있습니다.

배치된 자원을 프로젝트로 이동하는 프로세스를 보고 학습합니다.

동영상 시청을 통한 학습

동영상 대본

나는 IBM Cloud 개발 팀의 STSM인 Gili Mendel입니다. IBM Cloud 배치 가능한 아키텍처 또는 프로젝트에서 Schematics 작업공간을 이동하는 방법을 보여줍니다.

Schematics 작업공간은 IBM Cloud에서 Terraform 자동화를 실행하는 방법입니다. 작업공간은 Terraform 템플리트를 페치하는 Git 저장소에 대한 링크를 보유합니다. 또한 템플리트 변수를 보유하고 자원이 작성될 때 상태를 유지합니다.

클라우드 리소스 제공자에 대한 긴밀한 통합을 통해 상태에 대한 고가용성 IBM Cloud® Object Storage 버킷을 유지보수하지 않고 클라우드에서 Terraform IaaS 자동화를 실행하는 좋은 방법입니다.

그러나 여러 자동화를 수행하는 경우에는 이 접근 방식이 확장되지 않습니다. 자원을 관리하고 새 버전의 템플리트를 롤업하는 것은 어려운 태스크일 수 있습니다.

엔터프라이즈는 Terraform 자동화를 활용하지만 배치 가능한 아키텍처에 대한 모든 것입니다. 준수 풋프린트 지정, 비용 추정 및 아키텍처의 배치를 자동화하는 Terraform 템플리트를 사용하여 참조 아키텍처를 공개합니다.

Git 저장소는 아키텍처 및 해당 자동화를 반복하고 빌드하는 데 사용됩니다. 아키텍처를 배치하는 사용자에게 표시되거나 표시되지 않을 수 있습니다. 아키텍처 자체에는 버전 업그레이드를 포함하는 라이프사이클이 있습니다.

1단계: 카탈로그 관리 CLI를 사용하여 기존 작업공간에서 배치 가능한 아키텍처를 작성하고 새 버전을 공개하는 데 필요한 라이프사이클을 작성하십시오.

2단계: 프로젝트 CLI를 사용하여 프로젝트에서 배치 가능한 아키텍처로 관리되도록 작업공간을 수정하십시오. 이와 같이 이러한 자원은 배치 가능한 단일 아키텍처 버전 구성으로 처리할 수 있으며 여러 환경의 관리 계정에서 관리할 수 있습니다. 버전 마이그레이션, 비용 및 준수 풋프린트는 더 단순하며 모두 배치되는 아키텍처와 관련되어 있습니다.

시작하기 전에

IBM Cloud® Schematics 작업공간 이 작성되고 리소스가 계정에서 프로비저닝되는지 확인하십시오. 프로젝트 및 작업공간은 동일한 계정에 있어야 합니다.
Git 소스 리포지토리로 인증하도록 GIT_TOKEN 환경 변수를 설정하세요. 예를 들어, export GIT_TOKEN="enter your GIT TOKEN" 를 실행하십시오. 배포된 리소스를 프로젝트에 옮기면서 이러한 Git 관련 작업을 완료하려면 토큰에 권한이 필요합니다.
프로젝트를 카탈로그와 함께 연결하기 위한 인증 방법을 설정합니다. 다음 메소드 중 하나를 사용할 수 있습니다.
- IBM Cloud 계정에 액세스하도록 IC_API_KEY 환경 변수를 설정하십시오. 예를 들어, IC_API_KEY="Your API key" 를 실행하십시오.
- trusted-profile-id 세부사항을 사용하여 IBM Cloud 계정에 액세스하십시오. 자세한 정보는 신뢰할 수 있는 프로파일 ID찾기 를 참조하십시오. 예를 들어, 신뢰할 수 있는 프로파일 ID는 Profile-1bd5eala-000-4a6666-00000 와 유사할 수 있습니다.
프로젝트 및 카탈로그 관리 CLI 플러그인이 최신 상태인지 확인하십시오. ibmcloud plugin list 명령을 실행하여 CLI 플러그인의 현재 버전을 보십시오.
프로덕션 배치를 위한 프로젝트를 작성하고 자원을 이동할 프로젝트의 이름 및 ID를 기록하십시오.
다른 IBM Cloud 서비스와 통신할 수 있도록 사용자 계정에서 프로젝트 서비스에 권한이 부여되었는지 확인하십시오. 자세한 정보는 프로젝트 서비스와 기타 IBM Cloud 서비스 간의 액세스 부여 를 참조하십시오.

Schematics 작업공간에서 배치 가능한 아키텍처 작성

Schematics 작업공간에 배치 가능한 아키텍처가 이미 있는 경우 이 섹션을 건너뛰십시오.

Schematics 작업공간을 사용하거나 개인용 카탈로그를 통해 소프트웨어를 배치한 경우 ibmcloud catalog utility create-product-from-workspace 명령을 사용하여 배치된 리소스를 프로젝트로 이동할 수 있습니다.

명령은 다음 Git관련 태스크를 수행합니다.

배치 가능한 아키텍처 저장소를 복제합니다.
ibm_catalog.json Manifest 파일을 새 분기에 푸시합니다.
플레이스홀더 아키텍처 다이어그램 (architecture-diagram-placeholder.drawio.svg) 을 작성합니다.
저장소에서 Git 릴리스를 작성합니다.
릴리스 에셋을 제공합니다 URL.

이 명령은 다음 IBM Cloud-관련 작업도 완료합니다:

IBM Cloud에서 개인용 카탈로그를 작성합니다.
개발 및 테스트를 수행하는 프로젝트를 작성합니다.
신뢰할 수 있는 프로파일 ID 또는 API키를 사용하여 프로젝트와 카탈로그를 함께 링크합니다.
개인용 카탈로그에서 제품 타일을 작성합니다.
제품 버전을 새 개인용 카탈로그에 온보드합니다.
버전을 공유할 준비가 된 것으로 표시합니다.
작업공간을 카탈로그로 이동하여 작업공간 및 배치 가능한 아키텍처의 온보딩을 완료합니다.
프로젝트 ID, 카탈로그 ID, 오퍼링 ID및 버전 위치 지정자를 표시합니다.

배치 가능한 아키텍처를 작성하고 배치된 모든 자원을 프로젝트 구성으로 이동하려면 다음 단계를 완료하십시오.

ibmcloud catalog utility create-product-from-workspace 명령을 실행하십시오.

ibmcloud catalog utility create-product-from-workspace [--workspace-id ID] [--api-key KEY] [--trusted-profile-id ID] [--catalog-label LABEL] [--offering-label LABEL] [--project-name NAME] [--project-resource-group GROUP] [--target-version VERSION] [--variation-label LABEL]

--api-key 및 --trusted-profile-id 는 상호 배타적입니다. 둘 중 하나만 필요합니다. --project-name 매개변수는 개발 및 테스트를 수행하는 프로젝트를 작성합니다. 단순성을 위해 작업공간 ID와 동일하게 이름을 지정할 수 있습니다.

utility create-product-from-workspace 명령 옵션의 다음 예제를 참조하십시오.

ibmcloud catalog utility create-product-from-workspace --workspace-id us-south.workspace.move.xxxx --api-key $IC_API_KEY --catalog-label myCatalog --offering-label myOffering --project-name myProject --project-resource-group Default --target-version 1.0.0 --variation-label test_standard

명령 실행이 완료되면 명령 프롬프트가 OK 를 리턴합니다.

커미트, 저장소 및 새 릴리스를 보고 Git 에서 결과를 확인하십시오. 버전이 있는 .tgz 파일을 볼 수 있습니다.
IBM Cloud 콘솔에서 결과를 확인하십시오.
1. 관리 > 카탈로그 > 개인용 카탈로그로 이동하십시오.
2. 새 개인용 카탈로그를 선택하십시오.
3. 개인용 카탈로그에서 새 제품을 선택한 후 버전 탭을 선택하십시오. 배치 가능한 아키텍처의 버전 1.0.0 (또는 유사) 가 있는지 확인하십시오. 개인용 카탈로그로 이동하면 바둑판식으로 동일하게 배치 가능한 아키텍처가 표시됩니다.
4. 탐색 메뉴 아이콘 > 프로젝트를 클릭하고 새 프로젝트를 보십시오.
5. 배치 가능한 아키텍처를 보려면 구성 탭을 선택하십시오. draft 상태인지 확인하십시오.

프로젝트 구성 작성

ibmcloud project config-create 명령은 프로젝트에서 다른 버전을 작성하고 필요에 따라 배치 가능한 아키텍처를 수정할 수 있는 프로젝트에서 Schematics 작업공간을 실행하도록 하는 프로젝트 구성을 작성합니다.

이 섹션을 시작하기 전에 개인용 카탈로그 및 실행 중인 Schematics 작업공간에 배치 가능한 아키텍처가 있고 해당 CRN을 알고 있는지 확인하십시오. IBM Cloud 콘솔의 리소스 목록에서 또는 CLI를 사용하여 작업공간 CRN을 찾을 수 있습니다.

IBM Cloud 콘솔: IBM Cloud 콘솔에서 탐색 메뉴 아이콘 > 리소스 목록 > 개발자 도구 > 작업공간을 클릭하고 CRN을 복사하십시오.
IBM Cloud CLI: ibmcloud schematics workspace get 명령을 실행하여 작업공간 CRN 세부사항을 페치하십시오. 예를 들어, ibmcloud schematics workspace get --id workspace-id --output destination folder --json output.json 를 실행하여 Schematics 작업공간 CRN 세부사항을 페치하십시오.

다음 단계를 완료하여 프로젝트 구성을 추가하고 Schematics 작업공간 자원을 프로젝트로 이동하십시오.

ibmcloud project config-create 명령을 실행하십시오.
```
ibmcloud project config-create --project-id PROJECT-ID [--schematics-workspace-crn SCHEMATICS-WORKSPACE-CRN] [--definition-name DEFINITION-NAME] [--definition-locator-id DEFINITION-LOCATOR-ID]
```
--project-id 값은 시작하기 전 단계에서 프로덕션 배포를 위해 만든 프로젝트의 ID입니다. --definition-locator-id 값은 이전 섹션의 버전 찾기와 동일합니다.

project config-create 명령 옵션의 다음 예제를 참조하십시오.
```
ibmcloud project config-create --project-id myProdProject --schematics-workspace-crn MyWorkspaceCRN --definition-name production-deployment --definition-locator-id myVersionLocator
```
명령 실행이 완료되면 명령 프롬프트가 이름, 상태 및 유형을 리턴합니다.
Terraform 템플리트가 프로젝트에 배치되었는지 확인하십시오.
1. IBM Cloud 콘솔에서 탐색 메뉴 아이콘 > 프로젝트를 클릭하십시오.
2. 배치 프로덕션을 위해 처음 작성한 프로젝트를 선택하고 구성 탭으로 이동하십시오.
3. 조치 아이콘 > 마지막 배치 보기를 클릭하십시오.
4. 배치 성공 섹션에서 성공적으로 배치된 변경사항 > 로그 를 클릭하여 프로젝트의 모든 배치된 자원을 보십시오.

이제 Schematics 작업공간 배치가 새 프로젝트 내에 있는 로그에 포함됩니다.

CLI를 사용하여 결과를 확인하려면 ibmcloud project get 또는 ibmcloud project list 명령을 실행하여 작업공간이 프로젝트로 이동되었는지 확인하십시오.

다음 단계

배치 가능한 아키텍처에 대한 나머지 프로세스를 완료하려면 다음 단계를 완료하십시오.

배치 가능한 아키텍처에 대한 배치 세부사항을 구성하십시오.
IAM 액세스를 정의하십시오.
아키텍처 다이어그램, 전제조건 및 강조표시를 추가하십시오.
준수 정보 (제어) 를 추가하십시오.
비용 예상을 수신하도록 다시 유효성 검증하십시오.

단계를 완료하는 방법에 대한 자세한 정보는 개인용 카탈로그에 사용자 정의된 배치 가능한 아키텍처 온보딩 을 참조하십시오.

자세한 정보는 엔터프라이즈 아키텍처 채택 을 참조하십시오.