Automation Hub の namespace を使用したコレクションのキュレート
namespace を使用して、組織内の自動化開発者が作成したコレクションを整理します。namespace を作成してコレクションをアップロードし、自動化タスクでエンドユーザーに役立つ追加情報およびリソースを追加します。
概要
はじめに
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 で権限を付与し、グループを作成します。
手順
- ローカルの Automation Hub にログインします。
- Groups に移動し、Create をクリックします。
- を入力します。Content Engineering としての Name モーダルの グループに対して、Create を クリックします。新しいグループが作成され、Groups ページが表示されます。
- Permissions タブで、Edit をクリックします。
- Namespaces で の権限を追加します。Add Namespace、Upload to Namespace と Change Namespace を選択します。
Save をクリックします。
新しいグループは、割り当てたパーミッションで作成されます。次に、グループにユーザーを追加できます。
- をクリックします。Users の タブGroups ページ。
- Add をクリックします。
- モーダルからユーザーを選択し、Add をクリックします。
まとめ
新しいグループは Automation Hub を使用して、以下を実行できます。
- namespace の作成
- namespace の詳細およびリソースページの編集
- 内部で開発されたコレクションの namespace へのアップロード
1.3. 名前空間の作成
開発者が Automation Hub にアップロードするコレクションをグループ化するために使用する namespace を作成できます。namespace の作成時に、その namespace の所有者として Automation Hub 内のグループを割り当てることができます。
前提条件
- を持っています。Add Namespaces と Upload to Namespaces 権限。
手順
- ローカルの Automation Hub にログインします。
- My Namespaces に移動します。
- Create をクリックして namespace name を指定し、Namespace owners グループを割り当てます。
- Create をクリックします。
コンテンツ開発者は、新しい namespace にコレクションをアップロードするか、所有者として割り当てられたグループのユーザーにコレクションのアップロードを許可することができます。
1.4. namespace への情報およびリソースの追加
namespace に含まれるコレクションに付随する情報を追加し、ユーザーにリソースを提供できます。ロゴ、説明を追加し、ユーザーを GitHub リポジトリー、案件管理、またはその他のオンラインアセットにリンクします。また、マークダウンテキストを入力することもできます。 Edit resources タブを使用して、自動化タスクでコレクションを使用するエンドユーザーに役立つ追加情報を追加します。
前提条件
- を持っています。Change Namespaces 権限。
手順
- ローカルの Automation Hub にログインします。
- My Namespaces に移動します。
- をクリックし、Edit namespace
- Edit details タブで、フィールドに情報を入力して名前空間のエクスペリエンスを向上させます。
- をクリックします。edit resources タブをクリックして、テキストフィールドにマークダウンを入力します。
- 終了したら Save をクリックします。
コンテンツ開発者は、新しい namespace にコレクションをアップロードするか、所有者として割り当てられたグループのユーザーにコレクションのアップロードを許可することができます。
namespace が作成されると、これにアップロードするパーミッションを持つグループが承認用のコレクションの追加を開始できます。承認されると、ネームスペース内のコレクションが Published レポジトリー内に表示されます。
1.5. コレクションの namespace へのアップロード
Automation Hub 管理者によるレビューと承認のために、内部で開発されたコレクションをローカルの Automation Hub namespace にアップロードできます。承認されると、コレクションは、Automation Hub ユーザーが表示およびダウンロードできる Published コンテンツリポジトリーに移動します。
コレクションファイル名は <NAMESPACE-COLLECTION-NAME.tar.gz> のような形式にします。
前提条件
- コレクションをアップロードできる namespace がある。
手順
- ローカルの Automation Hub にログインします。
- My Namespaces に移動し、namespace を選択します。
- Upload collection をクリックします。
- Select file from the New collection モーダル。
- アップロードするコレクションを選択します。
- アップロード をクリックします。
My Imports 画面はテストの概要を提供し、コレクションのアップロードが成功または失敗したかを通知します。
1.6. namespace インポートログの確認
namespace にアップロードしたコレクションのステータスを確認して、プロセスの成功または失敗を評価できます。
インポートされたコレクション情報には以下が含まれます。
- Status - 完了または失敗
- Approval status - 承認待ちまたは承認済み
- Version - アップロードされたコレクションのバージョン
- Import log - コレクションのインポート中に実行されるアクティビティー
前提条件
- コレクションのアップロードが可能な namespace へのアクセスがある。
手順
- ローカルの Automation Hub にログインします。
- My Namespaces に移動します。
- namespace を選択します。
- をクリックし、My imports
- 検索フィールドを使用するか、一覧からインポートされたコレクションを見つけます。
- インポートされたコレクションをクリックします。
コレクションのインポートの詳細を確認し、namespace 内のコレクションのステータスを確認します。
第2章 まとめ
- 上記の手順を完了すると、以下が実行されます。
- パーミッションを持つグループを作成し、namespace をキュレートし、コレクションをこれにアップロードします。
- 自動化タスクでコレクションのエンドユーザーを支援する情報とリソースを namespace に追加します。
- コレクションを namespace にアップロードします。
- namespace インポートログを確認し、コレクションのアップロードの成功または失敗のほか、現在の承認ステータスを判断します。