자동화 콘텐츠 개발

프로세스

1. VS Code에서 프로젝트 디렉터리로 이동합니다.
2. VS Code 활동 표시줄에서 Ansible 아이콘을 클릭하여 Ansible 확장을 엽니다.
3. Ansible 확장의 Ansible 개발 툴 섹션에서 ADD 옵션까지 아래로 스크롤하여 Devcontainer 를 선택합니다.

4. Create a devcontainer 페이지의 컨테이너 이미지 옵션에서 Downstream 컨테이너 이미지를 선택합니다.

   이 작업은 .devcontainer 디렉터리에 Podman 및 Docker 모두에 devcontainer.json 파일을 추가합니다.

5. 프로젝트 디렉터리를 다시 열거나 다시 로드합니다.

   • VS Code에서 디렉터리에 devcontainer.json 파일이 포함되어 있음을 감지하면 다음 알림이 표시됩니다.

     

     컨테이너에서 다시 열기를 클릭합니다.

   • 알림이 나타나지 않으면 원격 ( ) 아이콘을 클릭합니다. 표시되는 드롭다운 메뉴에서 Reopen in Container 를 선택합니다.

6. 사용 중인 컨테이너화 플랫폼에 따라 Podman 또는 Docker의 dev 컨테이너를 선택합니다.

   VS Code 상태 표시줄의 Remote () 상태가 Remote를 열고 알림은 컨테이너를 여는 진행 상황을 나타냅니다.

프로세스

1. 다음 명령을 실행하여 SCA(Simple Content Access)가 활성화되어 있는지 확인합니다.

   $ sudo subscription-manager status

   Copy to clipboard

   Simple Content Access를 활성화하면 출력에 다음 메시지가 포함됩니다.

   Content Access Mode is set to Simple Content Access.

   Copy to clipboard

   1. Simple Content Access가 활성화되지 않은 경우 Red Hat Ansible Automation Platform SKU를 연결합니다.

      $ sudo subscription-manager attach --pool=<sku-pool-id>

      Copy to clipboard

2. 다음 명령을 사용하여 Ansible 개발 툴을 설치합니다.

   $ sudo dnf install --enablerepo=ansible-automation-platform-2.5-for-rhel-8-x86_64-rpms ansible-dev-tools

   Copy to clipboard

   $ sudo dnf install --enablerepo=ansible-automation-platform-2.5-for-rhel-9-x86_64-rpms ansible-dev-tools

   Copy to clipboard

프로세스

1. 플레이북의 VS Code에 새 .yml 파일을 생성합니다(예: example_playbook.yml ). example site.yml 파일과 동일한 디렉터리 수준에 배치합니다.

2. 다음 예제 코드를 플레이북 파일에 추가하고 파일을 저장합니다. 플레이북은 로컬 시스템에 대해 ping 을 실행하는 단일 플레이로 구성됩니다.

   ---
   - name: My first play
     hosts: localhost
     tasks:
       - name: Ping my hosts
         ansible.builtin.ping:

   Copy to clipboard

   Ansible-lint 는 백그라운드에서 실행되며 터미널의 문제 탭에 오류를 표시합니다. 이 플레이북에는 오류가 없습니다.

   
3. 플레이북 파일을 저장합니다.

프로세스

1. 프로젝트 디렉터리를 git 리포지토리로 초기화합니다.
2. GitHub와 같은 소스 제어 시스템으로 프로젝트를 푸시합니다.

프로세스

1. 브라우저에서 자동화 컨트롤러에 로그인합니다.
2. 필요한 경우 소스 제어 시스템에 대한 소스 제어 인증 정보 유형을 구성합니다. 자세한 내용은 자동화 실행 사용의 새 인증 정보 생성 섹션을 참조하십시오. https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.5/html/using_automation_execution/controller-credentials#controller-create-credential
3. 자동화 컨트롤러에서 플레이북 프로젝트를 저장한 GitHub 리포지토리에 대한 프로젝트를 생성합니다. 자동화 실행 사용의 프로젝트 장을 참조하십시오.
4. 생성한 프로젝트에서 플레이북을 사용하는 작업 템플릿을 생성합니다. 자동화 실행 사용의 작업 템플릿 장을 참조하십시오.
5. 작업 템플릿을 시작하여 자동화 컨트롤러에서 플레이북을 실행합니다. 자동화 실행 사용의 작업 템플릿 시작 섹션을 참조하십시오.

프로세스

1. VS Code를 엽니다.
2. 역할 컬렉션을 생성할 디렉터리로 이동합니다.
3. VS Code 활동 표시줄에서 Ansible 아이콘을 클릭하여 Ansible 확장을 엽니다.

4. Ansible 콘텐츠 작성자 섹션에서 시작하기 를 선택합니다.

   Ansible 콘텐츠 작성자 탭이 열립니다.

5. 생성 섹션에서 Ansible 컬렉션 프로젝트를 클릭합니다.

   새 Ansible 프로젝트 생성 탭이 열립니다.

6. Ansible 프로젝트 생성 탭의 양식에 다음을 입력합니다.

   • namespace : 네임스페이스 의 이름을 입력합니다(예: company_namespace ).
   • collection : 컬렉션의 이름을 입력합니다(예: myapp_network ).

   • init path: 새 컬렉션을 스캐폴드할 디렉터리의 경로를 입력합니다.

     기존 디렉터리 이름을 입력하면 스캐폴드 프로세스가 해당 디렉터리의 콘텐츠를 덮어씁니다. 스캐폴드 프로세스를 사용하면 Force 옵션을 활성화하는 경우에만 기존 디렉터리를 사용할 수 있습니다.

     • 컨테이너화된 버전의 Ansible 개발 툴을 사용하는 경우 대상 디렉터리 경로는 로컬 시스템의 경로가 아닌 컨테이너를 기준으로 합니다. 컨테이너에서 현재 디렉터리 이름을 검색하려면 VS Code의 터미널에서 pwd 명령을 실행합니다. 컨테이너의 현재 디렉터리가 작업 공간인 경우 workspaces /<current_project>/collections 를 입력합니다.
     • 로컬로 설치된 Ansible Dev 툴 버전을 사용하는 경우 디렉터리의 전체 경로(예: /user/<username>/path/to/<collection_directory >)를 입력합니다.
7. 생성을 클릭합니다.

프로세스

1. 필요한 경우 해당 콘텐츠를 반영하도록 역할이 포함된 디렉터리의 이름을 바꿉니다(예: acl_config 또는 tacacs ).

   컬렉션의 역할에는 이름에 하이픈이 있을 수 없습니다. 밑줄 문자(_)를 대신 사용합니다.

2. 독립 실행형 역할의 역할 디렉터리를 컬렉션의 roles/ 디렉터리에 복사합니다.

   예를 들어 myapp_network 라는 컬렉션에서 myapp_network/roles/ 디렉터리에 역할을 추가합니다.

3. 독립 실행형 역할의 플러그인을 새 컬렉션의 plugins 디렉터리/ 에 복사합니다. 컬렉션 디렉터리 구조는 다음과 유사합니다.

   company_namespace
   └── myapp_network
       ├── ...
       ├── galaxy.yml
       ├── docs
       ├── extensions
       ├── meta
       ├── plugins
       ├── roles
       │   ├── acl_config
       │   │   ├── README.md
       │   │   ├── defaults
       │   │   ├── files
       │   │   ├── handlers
       │   │   ├── meta
       │   │   ├── tasks
       │   │   ├── templates
       │   │   ├── tests
       │   │   └── vars
       │   └── tacacs
       │       ├── README.md
       │       ├── default
       │       ├── files
       │       ├── handlers
       │       ├── meta
       │       ├── tasks
       │       ├── templates
       │       ├── tests
       │       └── vars
       │   ├── run
       ├── ...
       ├── tests
       └── vars

   Copy to clipboard

   run 역할은 컬렉션을 스캐폴드할 때 생성되는 기본 역할 디렉터리입니다.

4. 컬렉션의 새 역할에 대해 FQDN(정규화된 컬렉션 이름)을 사용하도록 플레이북을 업데이트합니다.

프로세스

1. 새 역할을 생성하려면 컬렉션을 만들 때 스캐폴드된 기본 실행 역할 디렉터리를 복사합니다.
2. 역할에서 tasks/main.yml 파일에서 수행할 작업을 정의합니다. 기존 플레이북에서 작업을 재사용할 역할을 생성하는 경우 플레이북 YAML 파일의 tasks 블록에 콘텐츠를 복사합니다. 작업 왼쪽에 있는 공백을 제거합니다. VS Code에서 ansible-lint 를 사용하여 YAML 코드를 확인합니다.
3. 역할이 다른 역할에 종속된 경우 meta/main.yml 파일에 종속성을 추가합니다.

1. 사전 요구 사항

   • 컬렉션을 tarball에 패키징합니다. 컬렉션 파일 이름을 다음과 같이 포맷합니다.

프로세스

1. 프라이빗 자동화 허브에서 컬렉션의 네임스페이스를 생성합니다. 자동화 콘텐츠 관리 가이드에서 네임스페이스 생성 을 참조하십시오.
2. 선택 사항: 네임스페이스에 정보를 추가합니다. 자동화 콘텐츠 관리 가이드에서 네임스페이스에 추가 정보 및 리소스 추가를 참조하십시오.
3. tarballs 컬렉션을 네임스페이스에 업로드합니다. 자동화 콘텐츠 관리 가이드에서 네임스페이스에 컬렉션 업로드를 참조하십시오.
4. 내부 게시에 대한 컬렉션을 승인합니다. 자동화 콘텐츠 관리 가이드에서 네임스페이스에 컬렉션 업로드를 참조하십시오.