자동화 허브 시작하기
Red Hat 자동화 허브를 Ansible 컬렉션 콘텐츠의 기본 서버로 구성
초록
머리말
Red Hat Ansible 자동화 허브는 Red Hat 및 기술 파트너가 지원하는 컨텐츠를 신속하게 찾아서 사용하여 가장 까다로운 환경에 자동화 솔루션을 제공할 수 있는 공간을 제공합니다.
Ansible Galaxy 클라이언트 ansible-gal Galaxy
y는 명령줄에서 역할 및 컬렉션을 관리합니다. ansible-
gal#178y 클라이언트가 가능한 한 지원되는 인증된 Ansible 컬렉션을 사용하도록 하려면 Ansible .cfg
파일을 업데이트하여 Red Hat 자동화 허브를 Ansible 컬렉션의 기본 소스로 사용합니다.
Red Hat 문서에 관한 피드백 제공
이 문서를 개선하기 위한 제안이 있거나 오류를 찾을 수 있는 경우 https://access.redhat.com 에서 기술 지원에 문의하여 요청을 열 수 있습니다.
1장. 자동화 허브와 프라이빗 자동화 허브 간의 차이점
Red Hat Ansible Automation Platform은 Ansible 자동화를 다운로드하고 통합할 수 있는 자동화 콘텐츠의 중앙 위치로 자동화 허브를 사용합니다. 두 가지 유형의 허브를 사용할 수 있습니다.
- 자동화 허브
- Red Hat에서 Red Hat Hybrid Cloud Console 에서 호스트하며 Red Hat 지원 또는 인증 콘텐츠만 포함되어 있습니다.
- 프라이빗 자동화 허브
- 이는 자체 호스팅 콘텐츠 관리 시스템입니다. 이를 사용하여 모든 유형의 Ansible 콘텐츠에 액세스 및 관리하고 자동화 소비자가 사용할 수 있는 Ansible 콘텐츠 컬렉션 및 버전을 선택할 수 있습니다.
프라이빗 자동화 허브를 사용하면 다음 세 가지 유형의 콘텐츠에 액세스할 수 있습니다.
- Red Hat Hybrid Cloud Console 의 자동화 허브에 있는 Red Hat 인증 및 지원 콘텐츠 .
- Ansible Galaxy의 커뮤니티 콘텐츠.
- 조직에서 생성 및 선별하고 로컬에서 공유하는 개인 콘텐츠입니다.
2장. 자동화 허브에서 API 토큰 생성
컬렉션을 업로드하거나 다운로드하여 자동화 허브와 상호 작용하려면 먼저 API 토큰을 생성해야 합니다. 자동화 허브 API 토큰은 ansible-galxxxy 클라이언트를
Red Hat 자동화 허브 서버에 인증합니다.
자동화 허브는 기본 인증 또는 서비스 계정을 통한 인증을 지원하지 않습니다. 토큰 관리를 사용하여 인증해야 합니다.
API 토큰을 생성하는 방법은 사용 중인 자동화 허브 유형에 따라 다릅니다.
- Automation Hub는 오프라인 토큰 관리를 사용합니다. 자동화 허브에서 오프라인 토큰 생성 을 참조하십시오.
- 프라이빗 자동화 허브는 API 토큰 관리를 사용합니다. 프라이빗 자동화 허브에서 API 토큰 생성 을 참조하십시오.
- Keycloak을 사용하여 프라이빗 자동화 허브를 인증하는 경우 자동화 허브 에서 오프라인 토큰 생성 절차를 따르십시오.
2.1. 자동화 허브에서 오프라인 토큰 생성
자동화 허브에서는 토큰 관리를 사용하여 오프라인 토큰을 생성할 수 있습니다. 오프라인 토큰은 콘텐츠를 보호하는 데 사용되는 시크릿 토큰입니다.
절차
- Red Hat Hybrid Cloud Console에서 Ansible Automation Platform 으로 이동합니다.
- 탐색 패널에서 → 선택합니다.
- 오프라인 토큰 에서 을 클릭합니다.
- 아이콘을 클릭하여 오프라인 토큰을 복사합니다.
- 토큰을 파일에 붙여넣고 안전한 위치에 저장합니다.
오프라인 토큰은 콘텐츠를 보호하는 데 사용되는 시크릿 토큰입니다. 토큰을 안전한 위치에 저장합니다.
이제 ansible-galaxy
명령줄 툴을 사용하여 자동화 허브를 기본 컬렉션 서버로 구성하거나 컬렉션을 업로드하는 데 오프라인 토큰을 사용할 수 있습니다.
오프라인 토큰은 30일 동안 활동이 없으면 만료됩니다. 새로운 오프라인 토큰을 얻는 방법에 대한 자세한 내용은 오프라인 토큰 활성 유지를 참조하십시오.
2.2. 프라이빗 자동화 허브에서 API 토큰 생성
프라이빗 자동화 허브에서는 API 토큰 관리를 사용하여 API 토큰을 생성할 수 있습니다. API 토큰은 콘텐츠를 보호하는 데 사용되는 시크릿 토큰입니다.
사전 요구 사항
- Red Hat Ansible Automation Platform에 유효한 서브스크립션 인증 정보.
절차
- 프라이빗 자동화 허브에 로그인합니다.
- 탐색 패널에서 → 을 선택합니다.
- 를 클릭합니다.
- API 토큰을 복사하려면 아이콘을 클릭합니다.
- API 토큰을 파일에 붙여넣고 안전한 위치에 저장합니다.
API 토큰은 콘텐츠를 보호하는 데 사용되는 시크릿 토큰입니다. API 토큰을 안전한 위치에 저장합니다.
이제 자동화 허브를 기본 컬렉션 서버로 구성하거나 ansible-
galqcowy 명령줄 도구를 사용하여 컬렉션을 업로드하는 데 API 토큰을 사용할 수 있습니다.
API 토큰이 만료되지 않습니다.
2.3. 오프라인 토큰을 활성 상태로 유지
오프라인 토큰은 비활성 후 30일 후에 만료됩니다. 오프라인 토큰이 활성 상태를 유지하여 만료되지 않도록 유지할 수 있습니다.
오프라인 토큰을 활성 상태로 유지하는 것은 애플리케이션이 사용자를 대신하여 작업을 수행할 때 유용합니다. 예를 들어 사용자가 오프라인 상태일 때 애플리케이션이 일상적인 데이터 백업을 수행할 수 있습니다.
오프라인 토큰이 만료된 경우 새 토큰을 가져와야 합니다.
절차
다음 명령을 실행하여 토큰이 만료되지 않도록 합니다.
curl https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token -d grant_type=refresh_token -d client_id="cloud-services" -d refresh_token="{{ user_token }}" --fail --silent --show-error --output /dev/null
3장. Red Hat 자동화 허브를 콘텐츠의 기본 소스로 구성
Ansible 인증 콘텐츠 컬렉션에 액세스하려면 Red Hat 자동화 허브를 기본 콘텐츠 소스로 구성합니다. CLI(명령줄 인터페이스) 또는 웹 콘솔에서 자동화 허브를 구성할 수 있습니다.
3.1. CLI를 사용하여 Red Hat 자동화 허브를 기본 콘텐츠 소스로 구성
자동화 허브를 구성하려면 ansible.cfg
구성 파일을 업데이트해야 합니다. 기본적으로 ansible.cfg
구성 파일은 /etc/ansible/
디렉터리에 있습니다. 자동화 허브를 사용하면 인증 및 지원되는 컬렉션에 액세스할 수 있습니다.
사전 요구 사항
- 자동화 허브 서버의 API 토큰을 가져왔습니다. 자세한 내용은 Red Hat Automation Hub API 토큰 생성 을 참조하십시오.
새 토큰을 생성하면 자동화 허브용으로 생성된 이전 토큰이 취소됩니다. 새 토큰을 포함하도록 이전 토큰으로 생성된 자동화 컨트롤러 또는 스크립트를 업데이트합니다.
절차
-
ansible.cfg
파일을 엽니다. -
[galaxy]
섹션에server_list
옵션을 추가하고 하나 이상의 서버 이름을 포함합니다. 각 서버 이름에 대해 새 섹션을 생성합니다.
[galaxy_server._<server_name>_]
각 서버 이름에
url
옵션을 설정합니다.https://<server_fully_qualified_domain_name>/api/galaxy/
-
선택 사항:
auth_url
옵션을 설정합니다. 커뮤니티 Ansible Galaxy에는auth_url
이 필요하지 않습니다. - 자동화 허브 서버의 API 토큰을 설정합니다.
예제
다음 ansible.cfg
구성 파일 예제에서는 우선 순위가 지정된 순서로 여러 서버를 구성하는 방법을 보여줍니다. Automation Hub는 기본 소스 및 Ansible Galaxy 서버로 구성된 보조 소스로 구성됩니다.
ansible.cfg
[galaxy] server_list = automation_hub, my_org_hub [galaxy_server.automation_hub] url=https://console.redhat.com/api/automation-hub/content/published/ 1 auth_url=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token token=my_ah_token [galaxy_server.my_org_hub] url=https://automation.my_org/api/galaxy/content/rh-certified/ 2 username=my_user password=my_pass
301 리디렉션을 방지하려면 모든 API URL을 후행 슬래시 / 로 끝나야 합니다.
이제 자동화 허브를 기본 서버로 구성했습니다. 지원되는 컬렉션을 다운로드하여 설치할 수 있습니다.
추가 리소스
서버 목록 구성 옵션 및 Ansible 콘텐츠 소스로 Ansible Galaxy를 사용하는 방법에 대한 자세한 내용은 Ansible Galaxy 사용자 가이드를 참조하십시오.
3.2. 웹 콘솔을 사용하여 Red Hat 자동화 허브를 기본 콘텐츠 소스로 구성
자동화 허브를 구성하려면 인증 정보를 생성하여 조직의 Galaxy Credentials 필드에 추가해야 합니다. 자동화 허브를 사용하면 인증 및 지원되는 컬렉션에 액세스할 수 있습니다.
사전 요구 사항
- 자동화 허브 서버의 API 토큰을 가져왔습니다. 자세한 내용은 Red Hat Automation Hub API 토큰 생성 을 참조하십시오.
새 토큰을 생성하면 자동화 허브용으로 생성된 이전 토큰이 취소됩니다. 이전 토큰으로 생성된 자동화 컨트롤러 또는 스크립트를 업데이트합니다.
절차
- 자동화 컨트롤러로 이동합니다.
새 자격 증명을 생성합니다.
- 이동합니다.
- 를 클릭합니다.
- 이름 필드에 새 인증 정보의 이름을 입력합니다.
- 선택 사항: 설명을 입력하고 인증 정보가 연결된 조직의 이름을 입력하거나 선택합니다.
- 조직에서 인증 정보를 사용할 조직을 선택합니다.
- 인증 정보 유형으로 Ansible Galaxy/Automation Hub API 토큰 을 선택합니다.
- 유형 세부 정보 에서 이전에 생성한 Galaxy 서버 URL, 인증 서버 URL 및 API 토큰 을 입력합니다.
- 을 클릭합니다.
조직의 Galaxy 인증 정보 필드에서 생성한 인증 정보를 선택합니다.
- → 로 이동합니다.
- Galaxy 인증 정보를 추가할 조직을 선택합니다.
- 을 클릭합니다.
- Galaxy 인증 정보에서 아이콘을 클릭합니다.
- 자동화 허브용으로 생성한 인증 정보를 선택하여 목록 시작 부분에 배치합니다.
- 선택 사항: Ansible Galaxy와 같은 보조 콘텐츠 소스가 있는 경우 자동화 허브용으로 생성한 인증 정보 뒤에 이 인증 정보를 배치합니다.
- 를 클릭합니다.
- 을 클릭합니다.
검증
인증 정보를 확인하려면 프로젝트를 선택하고
아이콘을 클릭하여 기존 소스 제어 관리(SCM) 기반 프로젝트를 업데이트합니다.- 프로젝트 리포지토리로 이동합니다.
-
collections/requirements.yml
파일을 사용하는 프로젝트를 선택합니다. - 아이콘을 클릭하여 프로젝트를 업데이트합니다.
프로젝트의 Status 가 Successful 이면 인증 정보가 유효합니다.
이제 자동화 허브를 기본 서버로 구성했습니다. 지원되는 컬렉션을 다운로드하여 설치할 수 있습니다.
추가 리소스
- 서버 목록 구성 옵션 및 Ansible 콘텐츠 소스로 Ansible Galaxy를 사용하는 방법에 대한 자세한 내용은 Ansible Galaxy 사용자 가이드를 참조하십시오.
- 인증 정보를 생성하고 사용하는 방법에 대한 자세한 내용은 Automation Controller User Guide v4.2.1의 인증 정보 섹션을 참조하십시오.
4장. 프라이빗 자동화 허브에 대한 사용자 액세스 구성
특정 권한이 있는 사용자 그룹을 생성하여 자동화 허브의 콘텐츠 및 기능에 대한 사용자 액세스를 관리할 수 있습니다.
4.1. 사용자 액세스 구현
사용자 액세스는 특정 사용자에게 권한을 개별적으로 할당하는 대신 시스템 오브젝트(사용자, 그룹, 네임스페이스)에 대한 권한 관리를 기반으로 합니다.
생성한 그룹에 권한을 할당합니다. 그런 다음 사용자를 이러한 그룹에 할당할 수 있습니다. 즉, 그룹의 각 사용자에게 해당 그룹에 할당된 권한이 있습니다.
프라이빗 자동화 허브에서 생성된 그룹은 내부 컬렉션을 관리하는 시스템 관리자, 사용자 액세스 구성, 액세스 권한이 있는 그룹에 대한 리포지토리 관리를 담당하는 시스템 관리자부터 사설 자동화 허브에 내부적으로 개발된 콘텐츠를 구성하고 업로드할 수 있도록 합니다.
추가 리소스
- 시스템 권한에 대한 자세한 내용은 Automation Hub 권한을 참조하십시오.
4.1.1. 프라이빗 자동화 허브의 기본 사용자 액세스
자동화 허브를 설치하면 시스템이 Admin 그룹에 기본 관리자 사용자를 자동으로 생성합니다. Admin 그룹에는 시스템의 모든 권한이 할당됩니다.
다음 섹션에서는 프라이빗 자동화 허브에 액세스하고 목표를 달성하는 데 필요한 권한을 제공하는 사용자를 구성하는 것과 관련된 워크플로우에 대해 설명합니다. 사용 가능한 모든 권한에 대한 전체 목록 및 설명은 권한 참조 표를 참조하십시오.
4.1.2. 프라이빗 자동화 허브에서 새 그룹 생성
사용자가 시스템의 지정된 기능에 액세스할 수 있는 프라이빗 자동화 허브의 그룹에 권한을 생성하고 할당할 수 있습니다. 기본적으로 자동화 허브 의 관리 그룹에는 모든 권한이 할당되어 있으며 초기 로그인 시 사용할 수 있습니다. 프라이빗 자동화 허브를 설치할 때 생성된 인증 정보를 사용합니다.
자세한 내용은 자동화 허브 시작하기 가이드 의 프라이빗 자동화 허브에서 새 그룹 생성 을 참조하십시오.
4.1.3. 그룹에 권한 할당
기본적으로 새 그룹에는 할당된 권한이 없습니다. 사용자가 시스템의 특정 기능에 액세스할 수 있도록 개인 자동화 허브의 그룹에 권한을 할당할 수 있습니다.
그룹을 처음 만들거나 기존 그룹을 편집하여 권한을 추가하거나 제거할 때 권한을 추가할 수 있습니다.
자세한 내용은 자동화 허브 시작하기 가이드의 그룹에 권한 할당 을 참조하십시오.
4.1.4. 새 사용자를 생성하고 이를 허용
프라이빗 자동화 허브에서 사용자를 생성한 후 그룹에 추가하여 권한을 부여할 수 있습니다. 할당된 권한 수준과 연결된 시스템의 기능에 액세스할 수 있는 각 그룹입니다.
사전 요구 사항
- 사용자 권한이 있고 프라이빗 자동화 허브에서 사용자를 생성할 수 있습니다.
절차
- 프라이빗 자동화 허브에 로그인합니다.
- 탐색 패널에서 → 선택합니다.
- 클릭합니다.
- 필드에 정보를 입력합니다. 사용자 이름과 암호 가 필요합니다.
- 선택 사항: 사용자를 그룹에 할당하려면 그룹 필드를 클릭하고 그룹 목록에서 선택합니다.
- 을 클릭합니다.
이제 새 사용자가 사용자 페이지의 목록에 표시됩니다.
4.1.5. 슈퍼유저 생성
팀 전체에 관리를 분산하려면 프라이빗 자동화 허브에서 슈퍼유저를 생성할 수 있습니다.
사전 요구 사항
- 슈퍼유저여야 합니다.
절차
- 프라이빗 자동화 허브에 로그인합니다.
- 탐색 패널에서 → 선택합니다.
- 슈퍼유저를 만들 사용자를 선택합니다. 해당 사용자에 대한 사용자 세부 정보가 표시됩니다.
- 사용자 유형에서 슈퍼유저를 선택합니다.
이제 사용자에게 슈퍼유저 권한이 있습니다.
4.1.6. 기존 그룹에 사용자 추가
그룹을 생성할 때 그룹에 사용자를 추가할 수 있습니다. 그러나 기존 그룹에 사용자를 수동으로 추가할 수도 있습니다.
자세한 내용은 자동화 허브 시작하기 가이드에서 기존 그룹에 사용자 추가 를 참조하십시오.
4.1.7. 콘텐츠 큐레이터를 위한 새 그룹 생성
조직의 콘텐츠 큐레이션을 지원하도록 설계된 프라이빗 자동화 허브에서 새 그룹을 생성할 수 있습니다. 이 그룹은 프라이빗 자동화 허브에 게시하기 위해 내부적으로 개발한 컬렉션에 기여할 수 있습니다.
콘텐츠 개발자가 네임스페이스를 생성하고 내부적으로 개발한 컬렉션을 프라이빗 자동화 허브에 업로드하려면 먼저 그룹을 생성 및 편집하고 필요한 권한을 할당해야 합니다.
사전 요구 사항
- 프라이빗 자동화 허브에서 관리 권한이 있으며 그룹을 생성할 수 있습니다.
절차
- 프라이빗 자동화 허브에 로그인합니다.
- 탐색 패널에서 → 선택하고 을 클릭합니다.
- 모달에 그룹의 이름으로 Content Engineering 을 입력하고 을 클릭합니다. 새 그룹을 생성하고 그룹 페이지가 열립니다.
- 권한 탭에서 을 클릭합니다.
- 네임스페이스 에서 네임스페이스 추가, 네임스페이스에 업로드, 네임스페이스 변경을 위한 권한을 추가합니다 .
새 그룹은 사용자가 할당한 권한으로 생성됩니다. 그런 다음 그룹에 사용자를 추가할 수 있습니다.
- 그룹 페이지에서 사용자 탭을 클릭합니다.
- 를 클릭합니다.
- 사용자를 선택하고 를 클릭합니다.
4.1.8. 자동화 허브 권한
권한은 각 그룹이 지정된 오브젝트에서 수행할 수 있는 정의된 작업 세트를 제공합니다. 이 표에 설명된 권한에 따라 그룹에 필요한 액세스 수준을 결정합니다.
개체 | 권한 | 설명 |
---|---|---|
컬렉션 네임스페이스 | 네임스페이스 추가 네임스페이스에 업로드 네임스페이스 변경 네임스페이스 삭제 | 이러한 권한이 있는 그룹은 네임스페이스를 생성, 업로드 및 삭제할 수 있습니다. |
컬렉션 | Ansible 리포지토리 콘텐츠 수정 컬렉션 삭제 | 이 권한이 있는 그룹은 다음 작업을 수행할 수 있습니다. 승인 기능을 사용하여 리포지토리 간에 콘텐츠를 이동합니다. 스테이징 에서 게시 되거나 거부된 리포지토리로 콘텐츠를 이동하는 기능을 인증하거나 거부합니다. 컬렉션을 삭제합니다. |
사용자 | 사용자 보기 사용자 삭제 사용자 추가 사용자 변경 | 이러한 권한이 있는 그룹은 개인 자동화 허브에서 사용자 구성을 관리하고 액세스할 수 있습니다. |
groups | 그룹 보기 그룹 삭제 그룹 추가 그룹 변경 | 이러한 권한이 있는 그룹은 그룹 구성을 관리하고 프라이빗 자동화 허브에서 액세스할 수 있습니다. |
원격 컬렉션 | 원격 컬렉션 변경 원격 컬렉션 보기 | 이러한 권한이 있는 그룹은 → 로 이동하여 원격 리포지토리를 구성할 수 있습니다. |
컨테이너 | 컨테이너 네임스페이스 권한 변경 컨테이너 변경 이미지 태그 변경 새 컨테이너 만들기 기존 컨테이너로 푸시 컨테이너 리포지토리 삭제 | 이러한 권한이 있는 그룹은 프라이빗 자동화 허브에서 컨테이너 리포지토리를 관리할 수 있습니다. |
원격 레지스트리 | 원격 레지스트리 추가 원격 레지스트리 변경 원격 레지스트리 삭제 | 이러한 권한이 있는 그룹은 프라이빗 자동화 허브에 추가된 원격 레지스트리를 추가, 변경 또는 삭제할 수 있습니다. |
작업 관리 | 작업 변경 작업 삭제 모든 작업 보기 | 이러한 권한이 있는 그룹은 개인 자동화 허브에서 작업 관리에 추가된 작업을 관리할 수 있습니다. |
4.1.9. 프라이빗 자동화 허브에서 사용자 삭제
사용자 계정을 삭제하면 사용자의 이름과 이메일이 프라이빗 자동화 허브에서 영구적으로 제거됩니다.
사전 요구 사항
- 프라이빗 자동화 허브에서 사용자 권한이 있습니다.
절차
- 프라이빗 자동화 허브에 로그인합니다.
- 탐색 패널에서 → 선택합니다.
- 클릭하여 현재 사용자 목록을 표시합니다.
- 제거하려는 사용자 옆에 있는 (추가 작업 아이콘) 아이콘을 클릭한 다음 를 클릭합니다.
- 경고 메시지에서 를 클릭하여 사용자를 영구적으로 삭제합니다.
4.2. 프라이빗 자동화 허브에 대한 보기 전용 액세스 활성화
보기 전용 액세스를 활성화하면 사용자가 로그인할 필요 없이 프라이빗 자동화 허브의 컬렉션 또는 네임스페이스를 볼 수 있는 액세스 권한을 부여할 수 있습니다. 보기 전용 액세스를 사용하면 소스 코드를 보거나 다운로드하는 기능을 제한하면서 권한이 없는 사용자와 콘텐츠를 공유할 수 있습니다. 프라이빗 자동화 허브에서 편집할 수 있는 권한이 없습니다.
프라이빗 자동화 허브에 대한 보기 전용 액세스를 활성화하려면 Red Hat Ansible Automation Platform 설치 프로그램에서 인벤토리 파일을 편집해야 합니다.
-
Ansible Automation Platform의 새 인스턴스를 설치하는 경우 Automation
hub_enable_unauthenticated_collection_access
및automationhub_unauthenticated_unauthenticated_collection_download
매개변수를 다른 설치 구성과 함께인벤토리
파일에 추가합니다. -
보기 전용 액세스를 포함하도록 기존 Ansible Automation Platform 설치를 업데이트하는 경우
automationhub_enable_unauthenticated_collection_access
및automationhub_enable_unauthenticated_collection_download
매개변수를인벤토리
파일에 추가한 다음setup.sh
스크립트를 실행하여 업데이트를 적용합니다.
절차
설치 프로그램으로 이동합니다.
- 번들 설치
$ cd ansible-automation-platform-setup-bundle-<latest-version>
- 온라인 설치 관리자
$ cd ansible-automation-platform-setup-<latest-version>
-
텍스트 편집기로
인벤토리
파일을 엽니다. 다음 예제와 같이
automationhub_enable_unauthenticated_collection_access
및automationhub_enable_unauthenticated_collection_download
매개변수를 인벤토리 파일에 추가하고 둘 다True
로 설정합니다.[all:vars] automationhub_enable_unauthenticated_collection_access = True 1 automationhub_enable_unauthenticated_collection_download = True 2
-
setup.sh
스크립트를 실행합니다. 설치 프로그램을 사용하면 프라이빗 자동화 허브에 대한 보기 전용 액세스를 활성화합니다.
검증
설치가 완료되면 로그인하지 않고 프라이빗 자동화 허브의 콘텐츠를 확인하여 프라이빗 자동화 허브에 대한 보기 전용 액세스 권한이 있는지 확인합니다.
- 프라이빗 자동화 허브로 이동합니다.
- 로그인 화면에서 를 클릭합니다.
로그인하지 않고도 네임스페이스 또는 컬렉션과 같은 자동화 허브의 콘텐츠를 볼 수 있는지 확인합니다.
5장. Red Hat 자동화 허브에 콘텐츠 업로드
Automation Hub는 파트너에서 고객에게 지원되는 인증된 컬렉션을 배포합니다. 각 컬렉션에는 모듈, 역할, 플러그인 및 문서와 같은 내용이 포함되어 있습니다. 자동화 허브에 컬렉션을 처음 업로드하면 파트너 엔지니어링 팀이 인증을 위해 이를 검토합니다.
자동화 허브 사용자 인터페이스 또는 ansible-galaxy
클라이언트를 사용하여 컬렉션을 업로드하거나 삭제하여 컬렉션을 관리할 수 있습니다.
5.1. 자동화 허브에 컬렉션 업로드
Ansible 커뮤니티의 나머지 부분과 생성한 컬렉션을 공유하려면 자동화 허브에 업로드할 수 있습니다. 자동화 허브에 컬렉션을 업로드하면 파트너 엔지니어링 팀이 인증을 위해 이를 검토합니다.
자동화 허브 사용자 인터페이스 또는 ansible-galaxy
클라이언트를 사용하여 컬렉션을 업로드할 수 있습니다.
사전 요구 사항
-
Red Hat Automation Hub에 대한
ansible-galaxy
클라이언트를 구성했습니다. - 네임스페이스가 하나 이상 있어야 합니다.
-
ansible-test sanity
를 통해 모든 콘텐츠를 실행했습니다. - 고객님은 Red Hat Connect 파트너입니다. Red Hat Partner Connect 에서 자세히 알아보십시오.
절차
자동화 허브 사용자 인터페이스 사용:
- 탐색 패널에서 → 선택합니다.
- 내 네임스페이스 탭에서 컬렉션을 업로드할 네임스페이스를 찾습니다.
- 컬렉션 보기를 클릭하고 업로드 를 클릭합니다.
- 새 컬렉션 모달에서 클릭합니다. 시스템에서 파일을 찾습니다.
- 를 클릭합니다.
ansible-galaxy
클라이언트 사용:
다음 명령을 실행합니다.
ansible-galaxy collection publish path/to/my_namespace-my_collection-1.0.0.tar.gz --api-key=SECRET
다음 단계
- 컬렉션을 업로드한 후 파트너 인증 프로세스를 입력합니다. Red Hat의 파트너 엔지니어링 팀이 컬렉션의 인증 상태를 귀하에게 연락을 드릴 것입니다.
5.2. 자동화 허브에서 컬렉션 삭제
컬렉션이 다른 컬렉션에 의존하지 않는 경우 원하지 않는 컬렉션을 삭제하여 컬렉션을 추가로 관리할 수 있습니다. 컬렉션의 Dependencies 탭에는 현재 컬렉션을 사용하는 다른 컬렉션 목록이 표시됩니다.
사전 요구 사항
- 삭제되는 컬렉션에는 다른 컬렉션의 종속성이 없습니다.
- 컬렉션 삭제 권한이 있습니다.
절차
- 프라이빗 자동화 허브에 로그인합니다.
- 탐색 패널에서 컬렉션을 .
컬렉션을 삭제하기 전에 해당 컬렉션에 종속된 컬렉션이 있는지 확인합니다.
- 해당 컬렉션의 종속성 탭을 클릭합니다. 비어 있으면 컬렉션을 삭제할 수 있습니다. 종속 탭이 비어 있지 않은 경우 컬렉션을 삭제하기 전에 이러한 종속 항목을 삭제해야 합니다.
- 삭제할 컬렉션을 클릭합니다.
stat 를 클릭한 다음 옵션을 선택합니다.
아이콘 Cryo- 전체 컬렉션을 삭제 하여 이 컬렉션의 모든 버전을 삭제합니다.
버전 [number] 를 삭제하여 이 컬렉션의 현재 버전을 삭제합니다. 버전 드롭다운 메뉴를 사용하여 버전을 변경할 수 있습니다.
참고선택한 컬렉션에 다른 컬렉션의 종속성이 있는 경우 해당 종속성을 삭제할 때까지 이러한 작업이 비활성화됩니다. 종속성 탭을 클릭하여 삭제할 종속성 목록을 확인합니다.
- 확인 창이 열리면 컬렉션 또는 버전 번호가 올바른지 확인한 다음 삭제 를 선택합니다.