Red Hat Training
A Red Hat training course is available for Red Hat Satellite
Hammer チートシート
Red Hat Satellite 6.4 向けの Hammer CLI チートシート
Red Hat Satellite Documentation Team
satellite-doc-list@redhat.com概要
1. はじめに
Hammer は、Red Hat Satellite 6 で提供されるコマンドラインツールです。Hammer を使用すると、CLI コマンドまたはシェルスクリプトによる自動化により、Red Hat Satellite Server の設定と管理ができます。本ガイドでは、Hammer コマンドの概要を紹介します。
Hammer の詳細については、HAMMER CLI ガイド を参照してください。
2. 全般情報
表1 全般情報
| サブコマンド | 説明およびタスク |
|---|---|
|
|
hammer コマンドとオプションを表示します。サブコマンドを追加するとより詳細な情報が表示されます。 |
|
org |
この設定は組織に関するもので、 hammer defaults add \ --param-name organization_id \ --param-value org_ID |
|
loc |
この設定はロケーションに関するもので、 hammer defaults add \ --param-name location_id \ --param-value loc_ID |
注記: 本ガイドでは、認証情報が ~/.hammer/cli_config.yml に保存されていることを想定しています。詳細情報は、Red Hat Hammer CLI Guide の Authentication を参照してください。
3. 組織、ロケーション、リポジトリー
表2 組織、ロケーション、リポジトリー
| サブコマンド | 説明およびタスク |
|---|---|
|
|
組織を作成します。 hammer organization create \
--name org_name
組織を一覧表示します。 hammer organization list |
|
|
組織のオプションを参照してください。 |
|
|
サブスクリプションマニフェストをアップロードします。 hammer subscription upload \ --file path |
|
|
リポジトリーを有効にします。 hammer repository-set enable \ --product prod_name \ --basearch base_arch \ --releasever rel_v \ --name repo_name |
|
|
リポジトリーを同期します。 hammer repository synchronize \ --product prod_name \ --name repo_name カスタムリポジトリーを作成します。 hammer repository create \ --product prod_name \ --content-type cont_type \ --publish-via-http true \ --url repo_url \ --name repo_name カスタムリポジトリーにコンテンツをアップロードします。 hammer repository upload-content \ --product prod_name \ --id repo_id \ --path path_to_dir |
4. コンテンツのライフサイクル
表3 コンテンツのライフサイクル
| サブコマンド | 説明およびタスク |
|---|---|
|
|
ライフサイクル環境を作成します。 hammer lifecycle-environment create \ --name env_name --description env_desc --prior prior_env_name ライフサイクル環境を一覧表示します。 hammer lifecycle-environment list |
|
|
コンテンツビューを作成します。 hammer content-view create \ --name cv_n \ --repository-ids repo_ID1,... \ --description cv_description コンテンツビューにリポジトリーを追加します。 hammer content-view add-repository \ --name cv_n \ --repository-id repo_ID コンテンツビューに Puppet モジュールを追加します。 hammer content-view puppet-module add \ --content-view cv_n \ --name module_name コンテンツビューを公開します。 hammer content-view publish \
--id cv_ID
コンテンツビューをプロモートします。 hammer content-view version promote \ --content-view cv_n \ --to-lifecycle-environment env_name コンテンツビューの増分アップデートを実行します。 hammer content-view version incremental-update \ --content-view-version-id cv_ID \ --packages pkg_n1,... \ --environment-ids env_ID1,... |
5. 環境のプロビジョニング
表4 環境のプロビジョニング
| サブコマンド | 説明およびタスク |
|---|---|
|
|
ドメインを作成します。 hammer domain create \
--name domain_name
|
|
|
サブネットを追加します。 hammer subnet create \ --name subnet_name \ --organization-ids org_ID1,... \ --location-ids loc_ID1,... \ --domain-ids dom_ID1,... \ --boot-mode boot_mode \ --network network_address \ --mask netmask --ipam ipam |
|
|
コンピュートリソースを作成します。 hammer compute-resource create \ --name cr_name \ --organization-ids org_ID1,... \ --location-ids loc_ID1,... \ --provider provider_name |
|
|
インストールメディアを追加します。 hammer medium create \ --name med_name \ --path path_to_medium |
|
|
パーティションテーブルを追加します。 hammer partition-table create \ --name tab_name \ --path path_to_file \ --os-family os_family |
|
|
プロビジョニングテンプレートを追加します。 hammer template create \ --name tmp_name \ --file path_to_template |
|
|
オペレーティングシステムを追加します。 hammer os create \ --name os_name \ --version version_num |
6. アクティベーションキー
表5 アクティベーションキー
| サブコマンド | 説明およびタスク |
|---|---|
|
|
アクティベーションキーを作成します。 hammer activation-key create \ --name ak_name \ --content-view cv_n \ --lifecycle-environment lc_name サブスクリプションをアクティベーションキーに追加します。 hammer activation-key add-subscription \ --id ak_ID \ --subscription-id sub_ID |
7. ユーザーおよびパーミッション
表6 ユーザーおよびパーミッション
| サブコマンド | 説明およびタスク |
|---|---|
|
|
ユーザーを作成します。 hammer user create \ --login user_name \ --mail user_mail \ --auth-source-id 1 \ --organization-ids org_ID1,org_ID2,... ユーザーにロールを追加します。 hammer user add-role \ --id user_id \ --role role_name |
|
|
ユーザーグループを作成します。 hammer user-group create \
--name ug_name
ユーザーグループにロールを追加します。 hammer user-group add-role \ --id ug_id \ --role role_name |
|
|
ロールを作成します。 hammer role create \
--name role_name
|
|
|
フィルターを作成し、ロールに追加します。 hammer filter create \ --name role_name \ --permission-ids perm_ID1,perm_ID2,... |
8. Errata
表7 Errata
| サブコマンド | 説明およびタスク |
|---|---|
|
|
エラータを一覧表示します。 hammer erratum list CVE でエラータを検索します。 hammer erratum list --cve CVE エラータを確認します。 hammer erratum info --id err_ID
|
|
|
ホストに適用可能なエラータを一覧表示します。 hammer host errata list \
--host host_name
エラータをホストに適用します。 hammer host errata apply \ --host host_name \ --errata-ids err_ID1,err_ID2,... |
9. Docker コンテナー
表8 Docker コンテナー
| サブコマンド | 説明およびタスク |
|---|---|
|
|
コンテナーを作成します。 hammer docker container create \ --name container_name \ --compute-resource-id cr_ID \ --repository-name repo_name \ --tag tag --command command コンテナーを開始します。 hammer docker container start \
--id cont_ID
|
10. ホスト
表9 ホスト
| サブコマンド | 説明およびタスク |
|---|---|
|
|
ホストグループを作成します。 hammer hostgroup create \ --name hg_name \ --environment env_name \ --architecture arch_name \ --domain domain_name \ --subnet subnet_name \ --puppet-proxy proxy_name \ --puppet-ca-proxy ca-proxy_name \ --operatingsystem os_name \ --partition-table table_name \ --medium medium_name \ --organization-ids org_ID1,... \ --location-ids loc_ID1,... アクティベーションキーをホストグループに追加します。 hammer hostgroup set-parameter \
--hostgroup "hg_name" \
--name "kt_activation_keys" \
--value key_name
|
|
|
(ホストグループからパラメーターを継承する) ホストを作成します。 hammer host create \ --name host_name \ --hostgroup hg_name \ --interface="primary=true, \ mac=mac_addr, ip=ip_addr, \ provision=true" \ --organization-id org_ID \ --location-id loc_ID \ --ask-root-password yes |
|
|
リモート実行にジョブテンプレートを追加します。 hammer job-template create \ --file path \ --name template_name \ --provider-type SSH \ --job-category category_name |
|
|
リモートジョブを実行します。 hammer job-invocation create \ --job-template template_name \ --inputs key1=value,... \ --search-query query リモートジョブを監視します。 hammer job-invocation output \ --id job_id --host host_name |
11. タスク
表10 タスク
| サブコマンド | 説明およびタスク |
|---|---|
|
|
全タスクを一覧表示します。 hammer task list
Monitor progress of a running task:
hammer task progress \
--id task_ID
|
