콘솔을 사용하여 작업 만들기

Schematics 작업을 생성하고, 클라우드 리소스에 대해 실행할 ‘ Ansible ’ 플레이북을 지정합니다.

1. IBM Cloud 콘솔에 로그인합니다.

2. 메뉴 아이콘 > 플랫폼 자동화 >> Schematics > Ansible 를 클릭하고 플레이북 만들기로 이동합니다.

   • 플레이북을 만듭니다.

     1. 플레이북 이름과 작업에 대한 설명을 입력합니다. 이름은 길이가 최대 128자일 수 있으며 알파벳 문자, 공백, 대시 및 밑줄을 포함할 수 있습니다.
     2. Ansible 플레이북이 저장되어 있는 GitHub 또는 GitLab 저장소 URL을 입력하십시오. 해당 URL은 마스터 분기, 다른 분기 또는 서브디렉토리를 가리킵니다. 저장소에 플레이북이 여러 개 저장되어 있는 경우 실행할 플레이북을 선택해야 합니다. Schematics 조치는 한 번에 하나의 플레이북만 가리킬 수 있습니다. 여러 개의 플레이북을 실행하려면 플레이북마다 별도의 조치를 작성해야 합니다.

     플레이북이 없는 경우 샘플 플레이북 중 하나를 사용해 보세요.

     3. 선택 사항: 브랜치(선택 사항) 및 폴더(선택 사항) 를 입력합니다.
     4. 선택사항: 개인용 GitHub 저장소를 사용하려면 개인용 액세스 토큰을 입력하십시오. 개인 액세스 토큰은 개인용 GitHub 저장소를 인증하여 Ansible 플레이북에 액세스하는 데 사용됩니다. 액세스 토큰 생성 방법에 대한 자세한 내용은 CLI용 개인 액세스 토큰 생성을 참조하세요.

     자세한 내용은 Git 저장소에서 클로닝할 때 허용 및 차단되는 파일 확장자를 참조하십시오. 템플릿을 안전하게 검증하고 복제하려면 ‘ Open reference picker ’을 클릭하여 Secrets Manager 키 참조를 선택할 수 있습니다. 자세한 내용은 ‘ Secrets Manager 인스턴스 생성’을 참조하십시오.

   • 추가 정보

     1. 선택사항: 조치에 추가할 태그를 입력하십시오. 태그는 해당 작업의 빠른 검색에 도움이 됩니다.
     2. 조치를 작성하려는 리소스 그룹을 선택하십시오.
     3. 조치를 작성하려는 위치를 선택하십시오. 이 위치에 따라 조치를 실행하고 조치 데이터가 저장되는 위치가 결정됩니다. Dallas 또는 Frankfurt 과 같은 지역을 선택할 수 있습니다. 지역을 선택할 경우 Schematics에서 가용성을 기준으로 이 지역 내의 위치를 결정합니다. 조치가 작성된 후에는 위치를 변경할 수 없으므로 이 위치에 조치 데이터를 저장할 수 있는지 확인하십시오. 자세한 내용은 정보가 저장되는 위치를 참조하세요 Ansible 플레이북을 실행하려는 클라우드 리소스의 위치와 해당 작업의 위치가 서로 독립적이어야 합니다.

   • 인벤토리 선택 Ansible 플레이북을 실행할 호스트 그룹을 정의할 수 있습니다.

     1. 인벤토리 작성을 클릭하십시오.

     2. 인벤토리 이름을 입력하세요.

     3. 원격 호스트 요구 사항에 따라 연결 유형을 SSH 또는 WinRM 으로 선택합니다. 기본값은 SSH입니다.

        연결 유형은 원격 호스트에 연결할 때 SSH 및 WinRM 모두 지원합니다. SSH 의 경우 Bastion 호스트 액세스가 구성되어 있는지 확인합니다. WinRM 은 Windows 원격 호스트와 연결하는 데 사용됩니다. 현재 WinRM 은 공개 IPs 을 통해 Windows 시스템만 지원하며, Bastion 호스트 접속은 지원하지 않습니다.

     4. location 을 인증하고 인벤토리를 만들려는 Resource group 을 선택합니다.

     5. 호스트 그룹 작성을 클릭하십시오.

     6. 호스트 그룹의 이름을 입력하고 호스트 그룹에 추가할 대상 호스트를 프로비저닝한 Schematics 작업공간을 선택하십시오.

     7. 선택사항: 조회에 다른 조건을 추가하고 호스트 그룹에 추가될 대상 호스트 수를 제한하려면 조회 추가를 클릭하십시오. 리소스 이름 또는 태그를 사용하여 호스트를 식별하도록 선택할 수 있습니다. 자세한 정보는 지원되는 리소스 조회를 참조하십시오.

     8. 다른 조건 추가를 클릭하고 6~8단계를 반복하여 호스트 그룹을 더 추가합니다.

     9. 선택 사항입니다: 수동으로 정의 탭을 클릭하여 플레이북이 작동하는 호스트 및 호스트 그룹을 정의합니다.

     10. 파일 옵션에서 .ini 파일 형식을 사용하여 호스트 세부 정보를 입력합니다.

     11. 테이블 목록에서 리소스 인벤토리에 포함될 호스트 그룹을 선택하십시오.

     12. 인벤토리 생성을 클릭하여 플레이북이 작동하는 호스트 및 호스트 그룹을 정의하는 인벤토리 파일을 정의합니다.

3. 리소스 인벤토리 표에서 기존 리소스 인벤토리를 선택하고 편집 아이콘을 클릭합니다.

   • 자격증명 관리를 클릭하여 인벤토리 자격 증명을 구성합니다. 자세한 내용은 자격증명 관리하기를 참조하세요.
   • 변수 관리를 클릭하여 인벤토리 변수를 구성합니다. 자세한 내용은 변수 관리하기를 참조하세요.
   • 삭제를 클릭하여 인벤토리를 제거합니다.

4. 작성을 클릭하십시오. 액션이 ‘ Normal ’ 상태로 생성되었으며, ‘Details’ 섹션으로 이동합니다.

5. 실행하려는 작업을 확인하려면 작업 확인을 클릭하고 리소스가 플레이북에 연결되어 있는지 확인합니다. 작업 기록 섹션을 모니터링하여 로그에서 결과를 확인할 수 있습니다. 이 검사는 실행하려는 작업과 리소스가 플레이북에 제대로 연결되어 있는지 확인합니다.

   Schematics 조치의 실행 중인 작업은 삭제하거나 중지할 수 없습니다. 작업을 변경하려면 작업이 완료될 때까지 기다린 후 설정을 변경하고, 다시 ‘작업 확인’ 또는 ‘작업 실행’을 클릭하십시오.

6. 조치 실행을 클릭하여 조치를 실행하십시오. 작업 페이지에서 로그를 검토하여 조치의 진행상태를 모니터할 수 있습니다. 30 seconds마다 작업 로그가 자동으로 새로 고쳐집니다.

CLI를 사용하여 액션 만들기

1. 로컬 CLI 인터페이스에서 Schematics 플러그인을 설정합니다.
2. Ibmcloud 도식화 작업 생성 명령을 사용하여 작업을 생성합니다.
3. Ibmcloud schematics 인 벤토리 생성 명령을 사용하여 인벤토리를 생성합니다.
4. 로그를 확인하여 생성에 성공했는지 확인합니다.

API를 사용하여 액션 만들기

1. IAM 액세스 토큰을 검색하고 Schematics 로 인증합니다.
2. 선택 사항입니다: POST 요청을 전송하여 작업을 만듭니다.
3. POST 요청을 전송하여 인벤토리를 생성합니다.
4. 응답 상태를 확인하여 생성에 성공했는지 확인합니다.