Automation Hub에서 네임스페이스를 사용하여 컬렉션 큐레이션

Red Hat Ansible Automation Platform 2.4

자동화 허브의 네임스페이스를 사용하여 조직에서 개발한 컬렉션 큐

Red Hat Customer Content Services

초록

이 가이드에서는 네임스페이스를 사용하여 조직의 자동화 개발자가 생성한 컬렉션을 구성하는 방법을 보여줍니다. 네임스페이스를 생성하고, 컬렉션을 업로드하고, 자동화 작업에서 최종 사용자를 지원하는 추가 정보 및 리소스를 추가합니다.

머리말

자동화 허브에서 네임스페이스를 사용하여 조직에서 개발한 컬렉션을 큐레이트합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지를 참조하십시오.

Red Hat 문서에 관한 피드백 제공

Red Hat의 기술 콘텐츠에 대한 귀하의 피드백에 감사드리며, 귀하가 생각하는 것을 알려 주시기 바랍니다. 주석을 추가하거나, 인사이트를 제공하거나, 오타를 수정하거나, 질문을 하려면 문서에서 직접 이 작업을 수행할 수 있습니다.

참고

Red Hat 계정이 있어야 하며 고객 포털에 로그인해야 합니다.

고객 포털에서 문서 피드백을 제출하려면 다음을 수행하십시오.

  1. 다중 페이지 HTML 형식을 선택합니다.
  2. 문서 오른쪽 상단에 있는 피드백 버튼을 클릭합니다.
  3. 피드백을 제공하려는 텍스트 섹션을 강조 표시합니다.
  4. 강조 표시된 텍스트 옆에 있는 피드백 추가 대화 상자를 클릭합니다.
  5. 페이지 오른쪽에 있는 텍스트 상자에 피드백을 입력한 다음 제출을 클릭합니다.

피드백을 제출할 때마다 추적 문제가 자동으로 생성됩니다. Submit 을 클릭한 후 표시되는 링크를 열고 문제 모니터링을 시작하거나 의견을 더 추가합니다.

1장. 네임스페이스를 사용하여 자동화 허브에서 컬렉션 관리

자동화 허브에서 네임스페이스를 사용하여 내부 배포 및 사용을 위해 조직 내에서 개발된 컬렉션을 구성할 수 있습니다.

네임스페이스로 작업하려면 컬렉션을 생성, 편집 및 업로드할 수 있는 권한이 있는 그룹이 필요합니다. 네임스페이스에 업로드된 컬렉션에는 게시하고 사용할 수 있도록 하려면 관리자 승인이 필요할 수 있습니다.

1.1. 네임스페이스 정보

네임스페이스는 콘텐츠 컬렉션을 업로드하고 게시할 수 있는 자동화 허브에서 고유한 위치입니다. 자동화 허브의 네임스페이스에 대한 액세스는 여기에 표시되는 콘텐츠 및 관련 정보를 관리할 수 있는 권한이 있는 그룹에 의해 관리됩니다.

네임스페이스의 컬렉션 포맷

내부적으로 개발한 컬렉션을 다음 이름 규칙을 충족하는 tar.gz 파일 형식의 자동화 허브에 업로드할 수 있습니다. 

<my_namespace-my_collection-1.0.0.tar.gz>

1.2. 콘텐츠 큐레이터를 위한 새 그룹 생성

자동화 허브에서 게시를 위해 내부적으로 개발한 컬렉션을 기여하는 조직에서 콘텐츠 큐레이션을 지원하도록 설계된 자동화 허브에 새 그룹을 만들 수 있습니다.

이 섹션에서는 새 그룹을 만들고 콘텐츠 개발자가 네임스페이스를 만들고 컬렉션을 자동화 허브에 업로드하는 데 필요한 권한을 할당하는 방법을 설명합니다.

사전 요구 사항

  • 자동화 허브에서 관리자 권한이 있고 그룹을 생성합니다.

절차

  1. 로컬 자동화 허브에 로그인합니다.
  2. User Access → Groups 로 이동하여 Create 를 클릭합니다.
  3. 모달에 그룹 이름으로 Content Engineering 을 입력하고 생성을 클릭합니다. 새 그룹을 만들었으며 그룹 페이지가 표시됩니다.
  4. 권한 탭에서 편집 을 클릭합니다.
  5. 네임스페이스 에서 네임스페이스 추가 권한을 추가하고 네임스페이스에 업로드한 후 네임스페이스 를 변경합니다.

  6. 저장을 클릭합니다.

    새 그룹은 할당한 권한으로 생성됩니다. 그런 다음 그룹에 사용자를 추가할 수 있습니다.

  7. 그룹 페이지에서 사용자 탭을 클릭합니다.
  8. 추가 를 클릭합니다.
  9. 모달에서 사용자를 선택하고 추가 를 클릭합니다.

conclusion

이제 자동화 허브를 사용할 수 있는 새 그룹이 다음과 같습니다.

  • 네임스페이스를 생성합니다.
  • 네임스페이스 세부 정보 및 리소스 페이지를 편집합니다.
  • 내부적으로 개발한 컬렉션을 네임스페이스에 업로드합니다.

1.3. 네임스페이스 생성

네임스페이스를 생성하여 콘텐츠 개발자가 자동화 허브에 업로드하는 컬렉션을 구성할 수 있습니다. 네임스페이스를 생성할 때 자동화 허브의 그룹을 해당 네임스페이스의 소유자로 할당할 수 있습니다.

사전 요구 사항

  • 네임스페이스를 추가하고 네임스페이스 권한에 업로드합니다.

절차

  1. 로컬 자동화 허브에 로그인합니다.
  2. Automation Hub → 네임스페이스로 이동합니다.
  3. 생성을 클릭하고 네임스페이스 이름을 제공하고 네임스페이스 소유자 그룹을 할당합니다.
  4. 생성을 클릭합니다.

이제 콘텐츠 개발자가 컬렉션을 새 네임스페이스에 업로드하거나 소유자로 할당된 그룹의 사용자가 컬렉션을 업로드할 수 있도록 허용할 수 있습니다.

1.4. 네임스페이스에 추가 정보 및 리소스 추가

사용자가 네임스페이스에 포함된 컬렉션에 정보를 추가하고 리소스를 제공할 수 있습니다. 로고와 설명을 추가하고 사용자를 GitHub 리포지토리, 문제 추적기 또는 기타 온라인 자산에 연결합니다. Edit resources 탭에서 마크다운 텍스트를 입력하여 자세한 정보를 포함할 수도 있습니다. 이는 자동화 작업에서 컬렉션을 사용하는 최종 사용자에게 유용합니다.

사전 요구 사항

  • 네임스페이스 권한 변경 권한이 있습니다.

절차

  1. 로컬 자동화 허브에 로그인합니다.
  2. Automation Hub → 네임스페이스로 이동합니다.
  3. More Actions 아이콘 Cryostat 를 클릭하고 네임스페이스 편집을 선택합니다.
  4. Edit details 탭에서 필드에 정보를 제공하여 네임스페이스 환경을 향상시킵니다.
  5. 편집 리소스 탭을 클릭하여 텍스트 필드에 마크다운을 입력합니다.
  6. 완료되면 저장 을 클릭합니다.

이제 콘텐츠 개발자가 컬렉션을 새 네임스페이스에 업로드하거나 소유자로 할당된 그룹의 사용자가 컬렉션을 업로드할 수 있도록 허용할 수 있습니다.

네임스페이스를 생성할 때 업로드할 권한이 있는 그룹이 승인을 위해 컬렉션을 추가하기 시작할 수 있습니다. 승인 후 네임스페이스의 컬렉션은 게시 리포지토리에 표시됩니다.

1.5. 네임스페이스에 컬렉션 업로드

자동화 허브 관리자의 검토 및 승인을 위해 내부적으로 개발한 컬렉션을 로컬 자동화 허브 네임스페이스에 업로드할 수 있습니다. 승인되면 컬렉션은 자동화 허브 사용자가 보고 다운로드할 수 있는 게시된 콘텐츠 리포지토리로 이동합니다.

참고

컬렉션 파일 이름을 다음과 같이 포맷합니다. <NAMESPACE-COLLECTION-NAME.tar.gz>

사전 요구 사항

  • 컬렉션을 업로드할 수 있는 네임스페이스가 있습니다.

절차

  1. 로컬 자동화 허브에 로그인합니다.
  2. Automation Hub → 네임스페이스 로 이동하여 네임스페이스를 선택합니다.
  3. Upload collection 을 클릭합니다.
  4. 새 컬렉션 모달에서 파일 선택을 클릭합니다.
  5. 업로드할 컬렉션을 선택합니다.
  6. 업로드를 클릭합니다.

My Imports 화면에서는 테스트에 대한 요약을 제공하고 컬렉션이 성공적으로 업로드 또는 실패했는지 여부를 알려줍니다.

1.6. 네임스페이스 가져오기 로그 검토

네임스페이스에 업로드된 컬렉션의 상태를 검토하여 프로세스의 성공 또는 실패를 평가할 수 있습니다.

가져온 컬렉션 정보에는 다음이 포함됩니다.

상태
완료 또는 실패
승인 상태
승인 또는 승인 대기 중
버전
업로드된 컬렉션의 버전
로그 가져오기
컬렉션 가져오기 중 실행되는 활동

사전 요구 사항

  • 컬렉션을 업로드할 수 있는 네임스페이스에 액세스할 수 있습니다.

절차

  1. 로컬 자동화 허브에 로그인합니다.
  2. Automation Hub → 네임스페이스로 이동합니다.
  3. 네임스페이스를 선택합니다.
  4. More Actions 아이콘 Cryostat를 클릭하고 내 가져오기 를 선택합니다.
  5. 검색 필드를 사용하거나 목록에서 가져온 컬렉션을 찾습니다.
  6. 가져온 컬렉션을 클릭합니다.

컬렉션 가져오기 세부 정보를 검토하여 네임스페이스의 컬렉션 상태를 확인합니다.

1.7. 네임스페이스 삭제

원하지 않는 네임스페이스를 삭제하여 자동화 허브 서버에서 스토리지를 관리할 수 있습니다. 이렇게 하려면 네임스페이스에 종속성이 있는 컬렉션이 포함되어 있지 않은지 확인합니다.

사전 요구 사항

  • 삭제 중인 네임스페이스에 종속 항목이 있는 컬렉션이 없습니다.
  • 네임스페이스 권한이 삭제 되어 있습니다.

절차

  1. 로컬 자동화 허브에 로그인합니다.
  2. Collections → Namespaces 로 이동합니다.
  3. 삭제할 네임스페이스를 클릭합니다.

  4. More Actions 아이콘 Cryostat 를 클릭한 다음 네임스페이스 삭제 를 클릭합니다.

    참고

    네임스페이스 삭제 버튼이 비활성화된 경우 이 네임스페이스에 종속 항목이 있는 컬렉션이 포함되어 있음을 나타냅니다. 이 네임스페이스의 컬렉션을 검토하고 종속 항목을 삭제하여 네임스페이스 삭제를 진행합니다. 컬렉션 삭제에 대한 정보는 자동화 허브에 대한 컬렉션 삭제를 참조하십시오.

이제 삭제한 네임스페이스와 관련 컬렉션이 삭제되어 네임스페이스 목록 보기에서 제거됩니다.

2장. conclusion

이전 절차를 사용하여 다음을 수행할 수 있습니다.

  • 네임스페이스를 큐레이팅하고 컬렉션을 업로드할 권한이 있는 그룹을 생성합니다.
  • 자동화 작업에서 컬렉션의 최종 사용자를 지원하는 네임스페이스에 정보와 리소스를 추가합니다.
  • 네임스페이스로 컬렉션을 업로드합니다.
  • 네임스페이스 가져오기 로그를 검토하여 컬렉션을 업로드하는 성공 또는 실패와 현재 승인 상태를 확인합니다.

법적 공지

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.