Automation Hub の namespace を使用したコレクションのキュレート

Red Hat Ansible Automation Platform 2.1

namespace を使用して、組織内の自動化開発者が作成したコレクションを整理します。namespace を作成してコレクションをアップロードし、自動化タスクでエンドユーザーに役立つ追加情報およびリソースを追加します。

Red Hat Customer Content Services

概要

フィードバックの提供:
このドキュメントを改善するための提案がある場合、またはエラーを見つけた場合は、テクニカルサポート (https://access.redhat.com) に連絡し、Docs コンポーネントを使用して Ansible Automation Platform Jira プロジェクトで issue を作成してください。

はじめに

Automation Hub の namespace を使用して組織で開発されたコレクションをキュレートします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、今後の複数のリリースで段階的に用語の置き換えを実施して参ります。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。

第1章 namespace を使用した Automation Hub でのコレクションの管理

Automation Hub の namespace を使用して、内部での配布と使用のために組織内で開発されたコレクションを整理できます。

namespace を使用するには、コレクションを作成、編集、および namespace にアップロードする権限を持つグループが必要です。namespace にアップロードしたコレクションは、それらを公開して使用できるようにする前に、管理承認が必要になる場合があります。グループとパーミッションの詳細は、Automation Hub でのユーザーアクセスの管理 を参照し、コンテンツのキュレーターと開発者向けに Automation Hub を設定する方法を判断してください。

1.1. namespace について

namespace とは、コンテンツコレクションをアップロードおよび公開できる Automation Hub 内の一意の場所です。Automation Hub の namespace へのアクセスは、そこに表示されるコンテンツと関連情報を管理する権限を持つグループによって管理されます。

namespace のコレクションのフォーマット化

以下の命名規則を満たす tar.gz ファイル形式で、内部で開発したコレクションを Automation Hub にアップロードできます。

<my_namespace-my_collection-1.0.0.tar.gz>

1.2. コンテンツキュレーターの新規グループの作成

組織内のコンテンツキュレーションをサポートするように設計された Automation Hub で、新しいグループを作成できます。組織は、Automation Hub での公開用に内部で開発されたコレクションに提供します。

本セクションでは、新しいグループを作成し、コンテンツ開発者が namespace を作成してコレクションを Automation Hub にアップロードできるようにするために必要なパーミッションを割り当てます。

前提条件

  • を持っています。admin Automation Hub で権限を付与し、グループを作成します。

手順

  1. ローカルの Automation Hub にログインします。
  2. Groups に移動し、Create をクリックします。
  3. を入力します。Content Engineering としての Name モーダルの グループに対して、Create クリックします。新しいグループが作成され、Groups ページが表示されます。
  4. Permissions タブで、Edit をクリックします。
  5. Namespaces の権限を追加します。Add NamespaceUpload to NamespaceChange Namespace を選択します。
  6. Save をクリックします。

    新しいグループは、割り当てたパーミッションで作成されます。次に、グループにユーザーを追加できます。

  7. をクリックします。Users タブGroups ページ。
  8. Add をクリックします。
  9. モーダルからユーザーを選択し、Add をクリックします。

まとめ

新しいグループは Automation Hub を使用して、以下を実行できます。

  • namespace の作成
  • namespace の詳細およびリソースページの編集
  • 内部で開発されたコレクションの namespace へのアップロード

1.3. 名前空間の作成

開発者が Automation Hub にアップロードするコレクションをグループ化するために使用する namespace を作成できます。namespace の作成時に、その namespace の所有者として Automation Hub 内のグループを割り当てることができます。

前提条件

  • を持っています。Add NamespacesUpload to Namespaces 権限。

手順

  1. ローカルの Automation Hub にログインします。
  2. My Namespaces に移動します。
  3. Create をクリックして namespace name を指定し、Namespace owners グループを割り当てます。
  4. Create をクリックします。

コンテンツ開発者は、新しい namespace にコレクションをアップロードするか、所有者として割り当てられたグループのユーザーにコレクションのアップロードを許可することができます。

1.4. namespace への情報およびリソースの追加

namespace に含まれるコレクションに付随する情報を追加し、ユーザーにリソースを提供できます。ロゴ、説明を追加し、ユーザーを GitHub リポジトリー、案件管理、またはその他のオンラインアセットにリンクします。また、マークダウンテキストを入力することもできます。 Edit resources タブを使用して、自動化タスクでコレクションを使用するエンドユーザーに役立つ追加情報を追加します。

前提条件

  • を持っています。Change Namespaces 権限。

手順

  1. ローカルの Automation Hub にログインします。
  2. My Namespaces に移動します。
  3. More actions をクリックし、Edit namespace
  4. Edit details タブで、フィールドに情報を入力して名前空間のエクスペリエンスを向上させます。
  5. をクリックします。edit resources タブをクリックして、テキストフィールドにマークダウンを入力します。
  6. 終了したら Save をクリックします。

コンテンツ開発者は、新しい namespace にコレクションをアップロードするか、所有者として割り当てられたグループのユーザーにコレクションのアップロードを許可することができます。

namespace が作成されると、これにアップロードするパーミッションを持つグループが承認用のコレクションの追加を開始できます。承認されると、ネームスペース内のコレクションが Published レポジトリー内に表示されます。

1.5. コレクションの namespace へのアップロード

Automation Hub 管理者によるレビューと承認のために、内部で開発されたコレクションをローカルの Automation Hub namespace にアップロードできます。承認されると、コレクションは、Automation Hub ユーザーが表示およびダウンロードできる Published コンテンツリポジトリーに移動します。

注記

コレクションファイル名は <NAMESPACE-COLLECTION-NAME.tar.gz> のような形式にします。

前提条件

  • コレクションをアップロードできる namespace がある。

手順

  1. ローカルの Automation Hub にログインします。
  2. My Namespaces に移動し、namespace を選択します。
  3. Upload collection をクリックします。
  4. Select file from the New collection モーダル。
  5. アップロードするコレクションを選択します。
  6. アップロード をクリックします。

My Imports 画面はテストの概要を提供し、コレクションのアップロードが成功または失敗したかを通知します。

1.6. namespace インポートログの確認

namespace にアップロードしたコレクションのステータスを確認して、プロセスの成功または失敗を評価できます。

インポートされたコレクション情報には以下が含まれます。

  • Status - 完了または失敗
  • Approval status - 承認待ちまたは承認済み
  • Version - アップロードされたコレクションのバージョン
  • Import log - コレクションのインポート中に実行されるアクティビティー

前提条件

  • コレクションのアップロードが可能な namespace へのアクセスがある。

手順

  1. ローカルの Automation Hub にログインします。
  2. My Namespaces に移動します。
  3. namespace を選択します。
  4. More actions をクリックし、My imports
  5. 検索フィールドを使用するか、一覧からインポートされたコレクションを見つけます。
  6. インポートされたコレクションをクリックします。

コレクションのインポートの詳細を確認し、namespace 内のコレクションのステータスを確認します。

第2章 まとめ

上記の手順を完了すると、以下が実行されます。
  • パーミッションを持つグループを作成し、namespace をキュレートし、コレクションをこれにアップロードします。
  • 自動化タスクでコレクションのエンドユーザーを支援する情報とリソースを namespace に追加します。
  • コレクションを namespace にアップロードします。
  • namespace インポートログを確認し、コレクションのアップロードの成功または失敗のほか、現在の承認ステータスを判断します。

法律上の通知

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.