SLE MicroへのSUSE Manager 5.0プロキシの配備

このガイドでは、SUSE Manager 5.0プロキシの配備プロセスの概要を説明します。このガイドでは、SUSE Manager 5.0サーバが既に正常に配備済みであることを想定しています。

現時点では、SLE Microは正規のminionとして(デフォルト接続メソッド)のみサポートされています。Salt SSHクライアント(salt-ssh接続メソッド)としても管理できるように目指しています。

正常に配備するには、次のアクションを実行します。

プロシージャ: プロキシの配備

  1. ハードウェア要件を確認します。

  2. サーバ上でSLE Micro 5.5の親チャンネルとプロキシ拡張子チャンネルを同期します。

  3. ベアメタルマシンにSLE Micro 5.5をインストールします。

  4. During the installation, register SLE Micro 5.5 along with the SUSE Manager Proxy extension.

  5. Saltのアクティベーションキーを作成します。

  6. デフォルト接続メソッドを使用して、プロキシをクライアントとしてブートストラップします。

  7. プロキシ設定を生成します。

  8. サーバからプロキシにプロキシ設定を転送します。

  9. プロキシ設定を使用して、クライアントをSUSE Managerにプロキシとして登録します。

プロキシコンテナホストでサポートされるオペレーティングシステム

コンテナホストでサポートされているオペレーティングシステムはSLE Micro 5.5です。

コンテナホスト

コンテナホストは、コンテナを管理および配備できるPodmanなどのコンテナエンジンを搭載したサーバです。これらのコンテナは、アプリケーションと、ライブラリなどの重要な部品を保持していますが、完全なオペレーティングシステムは保持しないため軽量です。このセットアップにより、アプリケーションは異なる環境でも同じように動作します。CPU、メモリ、ストレージなど、これらのコンテナに必要なリソースはコンテナホストが提供します。

1. プロキシのハードウェア要件

次の表に、SUSE Managerプロキシを配備するためのハードウェア要件を示します。

Table 1. プロキシのハードウェア要件
ハードウェア 詳細 推奨

CPU

x86-64、ARM

専用64ビットCPUコア数は2つ以上

RAM

最小

2 GB

推奨

8 GB

ディスク容量

/ (ルートディレクトリ)

40 GB以上

/var/lib/containers/storage/volumes

150 GB以上

2. Synchronize the Parent and Proxy Extension Child Channels

このセクションは、サーバのWeb UIの管理  セットアップウィザード → 組織の資格情報で組織の資格情報を入力済みであることを想定しています。製品は、管理  セットアップウィザード → 製品ページに一覧表示されます。このチャンネルは、子チャンネルの［Proxy as an extension (プロキシを子チャンネルとして)］オプションを選択した状態で、サーバ上で完全に同期する必要があります。

プロシージャ: プロキシの親チャンネルとプロキシ拡張機能の同期

  1. SUSE ManagerのWeb UIで、管理  製品を選択します。

  2. ［製品］ページから、［フィルタ］フィールドに「SLE Micro」と入力します。

  3. 続いて、ドロップダウンを使用して必要なアーキテクチャを選択します。この例では、［x86-64］を選択します。

  4. In the Product Description field select the SLE Micro 5.5 checkbox then use the drop-down to select the SUSE Manager Proxy Extension 5.0 x86_64 extension.

  5. 製品の追加をクリックします。

  6. 同期が完了するまで待ちます。

3. SLE Micro 5.5のインストール

プロシージャ: インストールメディアのダウンロード

  1. https://www.suse.com/download/sle-micro/でSLE Micro 5.5のインストールメディアを見つけます。

  2. ISOをダウンロードするには、SUSE Customer Centerのアカウントが必要で、ログインしている必要があります。

  3. SLE-Micro-5.5-DVD-x86_64-GM-Media1.isoをダウンロードします。

  4. インストール用のUSBフラッシュディスクまたはDVDを準備します。

  5. SLE Micro 5.5のインストールイメージを含むDVDまたは起動可能なUSBスティックを挿入します。

  6. システムをブートまたは再起動します。

マシンのOS (仮想または物理)の準備の詳細については、SLE Micro 5.5 Deployment Guideを参照してください。

プロシージャ: SLE Micro 5.5のインストール

  1. 矢印キーを使用してインストールを選択します。

  2. キーボードと言語を調整します。チェックボックスをクリックしてライセンス契約に同意します。

  3. 次へをクリックして続行します。

  4. Select your registration method. For this example, we will register the proxy with SUSE Customer Center.

    拡張機能としてのSUSE Manager 5.0プロキシ

    SUSE Manager 5.0プロキシは拡張機能として登録されます。したがって、SLE Micro 5.5のSUSE Customer Center登録キーを入手するほかに、次の拡張機能用のSUSE Customer Center登録コードも必要です。

    • SUSE Manager 5.0プロキシ

  5. SUSE Customer Centerの電子メールアドレスを入力します。

  6. SLE Micro 5.5の登録コードを入力します。

  7. 次へをクリックして続行します。

  8. 拡張とモジュールの選択ページで、開発版を隠すチェックボックスをオフにします。

  9. SUSE Manager 5.0プロキシ拡張機能のチェックボックスをオンにします。

  10. 次へをクリックして続行します。

  11. SUSE Manager 5.0プロキシ拡張機能の登録コードを入力します。

  12. 次へをクリックして続行します。

  13. NTP設定ページで、次へをクリックします。

  14. Authentication for the System (システムの認証)ページで、rootユーザのパスワードを入力します。Click 次へをクリックします。

  15. インストール設定ページで、インストールをクリックします。

これにより、拡張機能としてのSLE Micro 5.5およびSUSE Manager 5.0プロキシのインストールが終了します。

3.1. システムの更新

プロシージャ: システムの更新

  1. rootとしてログインします。

  2. transactional-updateを実行します。

    transactional-update

  3. システムを再起動します。

  4. rootとしてログインします。

  5. コンテナユーティリティをインストールします。

    transactional-update pkg install mgrpxy mgrpxy-bash-completion

    • または、mgrpxy-zsh-completionまたはmgrpxy-fish-completionをインストールできます。

  6. システムを再起動します。

3.2. カスタム永続ストレージの設定

このステップはオプションです。ただし、ご使用のインフラストラクチャにカスタム永続ストレージが必要な場合は、mgr-storage-proxyツールを使用します。このツールを使用すると、コンテナ ストレージとSquidキャッシュボリュームの作成が容易になります。

このコマンドは次のように使用します。

mgr-storage-proxy <storage-disk-device>

例:

mgr-storage-proxy /dev/nvme1n1

詳細については、次のように入力します。

mgr-storage-proxy --help

このコマンドは、/var/lib/containers/storage/volumesに永続ストレージを作成します。

詳細については、以下を参照してください。

4. プロキシのアクティベーションキーの作成

プロシージャ: アクティベーションキーの作成

  1. システム  アクティベーションキーに移動し、キーの作成をクリックします。

  2. SLE Micro 5.5を親チャンネルとして使用して、プロキシホストのアクティベーションキーを作成します。このキーには、推奨されるすべてのチャンネルと、拡張機能としてのプロキシの子チャンネルが含まれる必要があります。

  3. 続行して、プロキシホストをデフォルトクライアントとしてブートストラップします。

5. クライアントとしてのプロキシホストのブートストラップ

プロシージャ: プロキシホストのブートストラップ

  1. システム  ブートストラップを選択します。

  2. プロキシホストのフィールドに入力します。

  3. ドロップダウンから、前のステップで作成したアクティベーションキーを選択します。

  4. Click ブートストラップをクリックします。

  5. ブートストラッププロセスが完了するまで待ちます。Saltメニューをチェックし、Saltキーが一覧表示されていて受け入れられていることを確認します。

  6. プロキシホストを再起動します。

  7. すべてのイベントが終了したら、システムの一覧からホストを選択して2回目の再起動をトリガし、オンボーディングを完了します。

プロシージャ: プロキシホストの更新

  1. システムの一覧からホストを選択し、すべてのパッチを適用してホストを更新します。

  2. プロキシホストを再起動します。

6. プロキシ設定の生成

SUSE Managerプロキシの設定アーカイブはSUSE Managerサーバによって生成されます。追加のプロキシごとに専用の設定アーカイブが必要です。

2 GBはプロキシSquidのデフォルトのキャッシュサイズを表します。これは環境に合わせて調整する必要があります。

Podmanの配備では、このプロキシ設定を生成する前に、SUSE ManagerプロキシのコンテナホストをSUSE Managerサーバにクライアントとして登録する必要があります。

プロキシFQDNを使用して、登録済みのクライアントではないプロキシコンテナ設定を生成すると(Kubernetesのユースケースと同様)、新しいシステムエントリがシステム一覧に表示されます。この新しいエントリは、以前に入力されたプロキシFQDN値の下に表示され、外部システムタイプになります。

6.1. Web UIを使用したプロキシ設定の生成

プロシージャ: Web UIを使用してプロキシコンテナ設定を生成する

  1. Web UIで、システム  プロキシの設定に移動し、必要なデータを入力します。

  2. ［プロキシFQDN］フィールドに、プロキシの完全修飾ドメイン名を入力します。

  3. ［親FQDN］フィールドに、SUSE Managerサーバまたは別のSUSE Managerプロキシの完全修飾ドメイン名を入力します。

  4. ［プロキシSSHポート］フィールドに、SSHサービスがSUSE ManagerプロキシでリスンしているSSHポートを入力します。デフォルトの8022を維持することをお勧めします。

  5. ［Squidの最大キャッシュサイズ[MB]］フィールドタイプで、Squidキャッシュの最大許容サイズ。コンテナで使用可能なストレージの最大60%で使用することを推奨します。

    2 GBはプロキシSquidのデフォルトのキャッシュサイズを表します。これは、環境に合わせて調整する必要があります。

［SSL証明書］選択リストで、SUSE Managerプロキシ用に新しいサーバ証明書を生成するか、既存のサーバ証明書を使用するかを選択します。 生成された証明書は、SUSE Manager組み込みの(自己署名)証明書とみなすことができます。

+ 選択に応じて、新しい証明書を生成するための署名CA証明書へのパス、またはプロキシ証明書として使用される既存の証明書とそのキーへのパスのいずれかを指定します。

+ サーバによって生成されたCA証明書は、/var/lib/containers/storage/volumes/root/_data/ssl-buildディレクトリに保存されます。

+ 既存の証明書またはカスタム証明書、および企業証明書と中間証明書の概念の詳細については、SSL証明書のインポートを参照してください。

  1. 生成をクリックして、SUSE Managerサーバに新しいプロキシFQDNを登録し、コンテナホストの詳細を含む設定アーカイブ(config.tar.gz)を生成します。

  2. しばらくすると、ダウンロードするファイルが表示されます。このファイルをローカルに保存します。

suma proxy containerized webui

6.2. spacecmdと自己署名証明書を使用したプロキシ設定ファイルの生成

spacecmdを使用してプロキシ設定を生成できます。

プロシージャ: spacecmdと自己署名証明書を使用してプロキシ設定を生成する

  1. SSHでコンテナホストに接続します。

  2. 次のコマンドを実行してサーバとプロキシFQDNを置き換えます。

    mgrctl exec -ti 'spacecmd proxy_container_config_generate_cert -- dev-pxy.example.com dev-srv.example.com 2048 email@example.com -o /tmp/config.tar.gz'

  3. 生成された設定をサーバコンテナからコピーします。

    mgrctl cp server:/tmp/config.tar.gz .

6.3. spacecmdとカスタム証明書を使用したプロキシ設定の生成

デフォルトの自己署名証明書ではなくカスタム証明書に対してspacecmdを使用して、プロキシ設定を生成できます。

プロシージャ: spacecmdとカスタム証明書を使用してプロキシ設定を生成する

  1. サーバコンテナホストにSSHで接続します。

  2. 次のコマンドを実行してサーバとプロキシFQDNを置き換えます。

    for f in ca.crt proxy.crt proxy.key; do
  mgrctl cp $f server:/tmp/$f
done
mgrctl exec -ti 'spacecmd proxy_container_config -- -p 8022 pxy.example.com srv.example.com 2048 email@example.com /tmp/ca.crt /tmp/proxy.crt /tmp/proxy.key -o /tmp/config.tar.gz'

  3. 生成された設定をサーバコンテナからコピーします。

    mgrctl cp server:/tmp/config.tar.gz .

7. プロキシ設定の転送

Web UIによって設定アーカイブが生成されます。このアーカイブをプロキシコンテナホストで利用できるようにする必要があります。

プロシージャ: プロキシ設定をコピーする

  1. If not already done, copy the configuration archive (config.tar.gz) generated in the previous step from the server container to the server host:

    mgrctl cp server:/root/config.tar.gz .

  2. If not already done, copy the files from the server host to the proxy host:

    scp config.tar.gz <proxy-FQDN>:/root

  3. On the proxy host, install the Proxy with:

    mgrpxy install podman config.tar.gz

8. Start the SUSE Manager Proxy

mgrpxyコマンドを使用してコンテナを起動できます。

プロシージャ: プロキシを起動してステータスを確認する

  1. 次のコマンドを呼び出してプロキシを起動します。

    mgrpxy start

  2. 次のコマンドを呼び出してコンテナのステータスを確認します。

    mgrpxy status

    5つのSUSE Managerプロキシコンテナが存在し、また、proxy-podコンテナポッドの一部である必要があります。

    • proxy-salt-broker

    • proxy-httpd

    • proxy-tftpd

    • proxy-squid

    • proxy-ssh

8.1. サービスにカスタムコンテナイメージを使用する

デフォルトでは、SUSE Managerプロキシスイートは、そのサービスごとに同じイメージバージョンとレジストリパスを使用するように設定されています。ただし、-tagおよび-imageで終わるインストールパラメータを使用して、特定のサービスのデフォルト値を上書きすることは可能です。

例:

mgrpxy install podman --httpd-tag 0.1.0 --httpd-image registry.opensuse.org/uyuni/proxy-httpd /path/to/config.tar.gz

これは、httpdサービスの設定ファイルを調整してから再起動します。registry.opensuse.org/uyuni/proxy-httpdsは使用するイメージ、0.1.0はバージョンタグです。

値をデフォルトにリセットするには、これらのパラメータを指定せずにもう一度installコマンドを実行します。

mgrpxy install podman /path/to/config.tar.gz

このコマンドは、すべてのサービスの設定をグローバルデフォルトにリセットして再ロードします。