Ansible 플레이북 작성

Schematics 에서 사용할 Ansible 플레이북을 만들려면 다음 전제 조건과 일반적인 단계를 따르세요.

기존 Ansible 플레이북을 사용하여 시작하고 싶으십니까? IBM 에서 제공하는 Ansible 플레이북 중 하나를 사용해 보거나 Ansible Galaxy 에서 기존 Ansible 컬렉션과 역할을 찾아보세요.

Ansible 플레이북을 실행할 리소스 인벤토리를 준비합니다. Schematics 의 기본 제공 Terraform 기능을 사용하여 대상 호스트를 프로비저닝할 수도 있습니다. 자세한 정보는 Schematics 작업공간을 사용하여 인프라 배치를 참조하십시오.
Ansible 플레이북을 개발하세요. IBM 에서 제공하는 플레이북 중 하나를 사용하거나 Ansible Galaxy 에서 기존 역할과 컬렉션을 탐색해 보세요. 필요에 따라 플레이북에서 이러한 역할 및 컬렉션](/docs/schematics?topic=schematics-create-playbook#schematics-collection)을 참조하세요.
GitHub 또는 GitLab 리포지토리를 설정하고 필요한 디렉토리 구조에 따라 Ansible 플레이북, 모듈, 역할 및 컬렉션을 구성합니다. 샘플 구조는 이 샘플 플레이북에서 확인할 수 있습니다.
Ansible 플레이북, 모듈, 역할 및 콜렉션을 GitHub 저장소에 업로드하십시오.
업로드한 플레이북을 사용하여 Schematics 액션을 만듭니다.

플레이북이 필요한 구조를 준수하고 Schematics 에서 원활한 실행을 위해 필요한 역할 및 컬렉션을 참조하는지 확인합니다. 자세한 내용은 Ansible 문서 또는 플레이북 생성을 참조하세요.

플레이북에서 Ansible 콜렉션 참조

Ansible 컬렉션은 플레이북에 설치하여 사용할 수 있는 플레이북, 모듈 및 역할과 같은 재사용 가능한 Ansible 리소스 그룹입니다. 컬렉션은 Ansible Galaxy 리포지토리에서 사용할 수 있습니다.

Ansible 역할과 마찬가지로, 콜렉션에는 GitHub 저장소의 특정 폴더 구조가 필요합니다.

Schematics 플레이북에서 컬렉션을 사용하려면 다음 단계를 따르세요

Ansible Galaxy를 검색하여 플레이북에 사용할 컬렉션을 찾아보세요.
requirements.yml 파일을 만들어 Ansible Galaxy에서 설치하려는 컬렉션을 지정합니다. 파일 구조는 Ansible 설명서를 따라야 합니다. 다음은 community.kubernetes 컬렉션을 사용한 예시입니다.
```
collections:
  - name: community.kubernetes
    version: 0.9.0
```
플레이북을 기준으로 GitHub 리포지토리에 collections 폴더를 추가하고 이 폴더 안에 requirements.yml 파일을 넣습니다.
```
├── collections
        └── requirements.yml
├── playbook.yaml
├── README.md
```
플레이북에서 콜렉션의 리소스를 참조하십시오. 자세한 내용은 Ansible 문서를 참조하세요. 플레이북의 폴더 구조가 요구 사항을 준수하고 Schematics 에서 원활하게 실행되도록 컬렉션을 올바르게 참조하는지 확인하세요.

Ansible 플레이북 준비하기 Schematics

Schematics 에서 Ansible 플레이북을 실행하기 전에 다음 사항을 고려하세요:

Ansible 플레이북을 GitHub 또는 GitLab 리포지토리에 저장하세요.
Ansible 리소스 인벤토리의 대상 호스트를 지정할 때는 제한 사항에 유의하세요. 자세한 내용은 Schematics 작업의 리소스 인벤토리 만들기 가이드라인을 참조하세요.
플레이북이 Schematics 에서 지원되는 Ansible 버전과 호환되는지 확인합니다. 지원되는 버전을 확인하려면 ibmcloud schematics version 명령을 실행하세요.
선택적으로 IBM 에서 제공하는 Ansible 플레이북 중 하나를 사용하여 Schematics 에서 Ansible 플레이북 기능을 살펴보세요.

다음 단계

Ansible 플레이북의 전제 조건과 준비 단계를 이해했다면 다음 단계는 Schematics 액션을 만드는 것입니다. 이 프로세스에는 Ansible 플레이북을 지정하고, 리소스 인벤토리를 구성하고, 필요한 자격 증명이나 변수를 설정하는 것이 포함됩니다. 계속하려면 Schematics 작업 만들기 가이드를 따르세요.