Documentation survey

SUSE Manager 5.0プロキシの配備

このガイドでは、SUSE Manager 5.0プロキシコンテナをSLE Micro 5.5またはSUSE Linux Enterprise Server 15 SP6に配備するプロセスの概要を説明します。このガイドでは、SUSE Manager 5.0サーバがすでに正常に配備済みであることを想定しています。

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

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

プロシージャ: プロキシを配備する
  1. ハードウェア要件を確認します。

  2. SLE Micro 5.5またはSUSE Linux Enterprise Server 15 SP6の親チャンネルとサーバ上のプロキシ拡張機能の子チャンネルを同期します。

  3. ベアメタルマシンにSLE MicroまたはSUSE Linux Enterprise Serverをインストールします。

  4. インストール時に、SLE MicroまたはSUSE Linux Enterprise ServerをSUSE Managerプロキシ拡張機能とともに登録します。

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

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

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

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

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

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

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

コンテナホスト

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

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

SUSE Managerプロキシを配備するためのハードウェア要件の詳細については、installation-and-upgrade:hardware-requirements.adoc#proxy-hardware-requirementsを参照してください。

2. 親とプロキシ拡張機能の子チャンネルの同期

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

プロシージャ: プロキシの親チャンネルとプロキシ拡張機能の同期
  1. SUSE ManagerのWeb UIで、管理  製品を選択します。

  2. [製品]ページから、フィルタフィールドに「SLE Micro」または「SUSE Linux Enterprise Server」を入力します。

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

  4. 製品説明フィールドで[SLE Micro 5.5 ]または[ SUSE Linux Enterprise Server 15 SP6]チェックボックスをオンにし、ドロップダウンを使用してSUSE Manager Proxy Extension 5.0 x86_64拡張機能を選択します。

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

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

3. SUSE Managerプロキシホストの準備

以下のサブセクションで、SLE MicroまたはSUSE Linux Enterprise Serverを使用してプロキシホストを準備します。

3.1. SLE Micro 5.5ホストの準備

3.1.1. インストールメディアのダウンロード

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

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

  3. インストール用のDVDまたはUSBフラッシュドライブ(ダウンロードした.isoイメージを含む)を準備します。

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

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

プロシージャ: SLE Micro 5.5のインストール
  1. SLE Micro 5.5のインストールイメージを含むDVDまたはUSBフラッシュドライブ(USBディスクまたはキー)を挿入します。

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

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

  4. キーボードと言語を調整します。

  5. チェックボックスをクリックしてライセンス契約に同意します。

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

  7. 登録方法を選択します。この例では、SUSE Customer Centerを使用してサーバを登録します。

    SUSE Manager 5.0コンテナは拡張機能としてインストールされます。以下のリストから必要な特定の拡張機能に応じて、それぞれに追加のSUSE Customer Center登録コードが必要です。

    • SUSE Manager 5.0サーバ

    • SUSE Manager 5.0プロキシ

    • SUSE Manager 5.0 Retail Branch Server

    SLE Micro 5.5エンタイトルメントはSUSE Managerエンタイトルメントに含まれているため、別途登録コードは必要ありません。

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

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

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

  11. プロキシをインストールするにはSUSE Manager 5.0プロキシ拡張機能、サーバをインストールするにはSUSE Manager 5.0サーバ拡張機能のチェックボックスを選択します。

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

  13. SUSE Manager 5.0拡張機能の登録コードを入力します。

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

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

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

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

これで、拡張機能としてのSLE Micro 5.5とSUSE Manager 5.0のインストールが完了しました。

3.1.3. オプション: コマンドラインからの登録

SLE Micro 5.5のインストール中にSUSE Manager 5.0を拡張機能として追加した場合は、このプロシージャはスキップして構いません。ただし、オプションで、登録を行なわずに次へ進むボタンを選択することによりSLE Micro 5.5のインストール中に登録をスキップできます。このセクションでは、SLE Micro 5.5のインストール後に製品を登録するステップについて説明します。

次のステップでは、SUSE Manager 5.0拡張機能をx86-64アーキテクチャに登録します。そのため、x86-64アーキテクチャの登録コードが必要になります。ARMまたはs390xアーキテクチャを登録する場合は、正しい登録コードを使用してください。

プロシージャ: コマンドラインからの登録
  1. 次のコマンドで利用可能な拡張機能を一覧表示します。

    transactional-update --quiet register --list-extensions
  2. 利用可能な拡張機能のリストから、インストールしたい拡張機能を選択します。

    1. サーバをインストールする場合は、次のコマンドで SUSE Manager Server Extension 5.0 x86_64の登録コードを使用します。

      transactional-update register -p SUSE-Manager-Server/5.0/x86_64 -r <reg_code>
    2. プロキシをインストールする場合は、次のコマンドでSUSE Manager Proxy Extension 5.0 x86_64の登録コードを使用します。

      transactional-update register -p SUSE-Manager-Proxy/5.0/x86_64 -r <reg_code>
  3. 再起動します。

3.1.4. システムの更新

プロシージャ: システムの更新
  1. rootとしてログインします。

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

    transactional-update
  3. 再起動します。

SLE Microはデフォルトで自動的に自己更新するように設定されており、更新が適用されると再起動します。ただし、この動作はSUSE Manager環境では望ましくありません。サーバの自動更新を防ぐために、SUSE Managerでは、ブートストラッププロセス中にトランザクション更新タイマーが無効化されます。

SLE Microのデフォルトの動作を使用したい場合は、次のコマンドを実行してタイマーを有効にします。

systemctl enable --now transactional-update.timer

配備を続行するには、カスタム永続ストレージの設定を参照してください。

3.2. SUSE Linux Enterprise Server 15 SP6ホストの準備

または、SUSE ManagerをSUSE Linux Enterprise Server 15 SP6に配備することもできます。

次のプロシージャでは、インストールプロセスの主なステップについて説明します。

プロシージャ: SUSE Linux Enterprise Server 15 SP6にSUSE Manager拡張機能をインストールする
  1. https://www.suse.com/download/sles/でSUSE Linux Enterprise Server 15 SP6 .isoを見つけてダウンロードします。

  2. ホストオペレーティングシステム(SUSE Linux Enterprise Server 15 SP6)と拡張機能の両方の登録コードがあることを確認します。

  3. SUSE Linux Enterprise Server 15 SP6のインストールを開始します。

    1. Language, Keyboard and Product Selection(言語、キーボードおよび製品の選択)で、インストールする製品を選択します。

    2. ライセンス契約で契約を読み、[I Agree to the License Terms( ライセンス条項に同意します)にチェックを付けます。

  4. 登録方法を選択します。この例では、SUSEカスタマーセンターにサーバを登録します。

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

  6. SUSE Linux Enterprise Server 15 SP6の登録コードを入力します。

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

    SUSE Linux Enterprise Server 15 SP6をご利用いただくには、有効なSUSE Linux Enterprise Serverサブスクリプションと対応する登録コードが必要です。これらの情報をこの画面に入力する必要があります。以下にSUSE Manager拡張機能の登録コードを入力する必要があります。

  8. 拡張とモジュールの選択で、以下にチェックを付けます。

    • サーバをインストールするにはSUSE Managerサーバ拡張機能を選択し、プロキシをインストールするにはSUSE Managerプロキシ拡張機能を選択します。

    • ベースシステムモジュール

    • Containersモジュール

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

  10. SUSE Manager 5.0拡張機能の登録コードを入力します。

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

  12. インストールを完了します。

  13. インストールが完了したら、rootとして新しくインストールしたサーバにログインします。

  14. システムを更新します(オプション。インストール時にシステムが更新をダウンロードするように設定されていない場合)。

    zypper up
  15. 再起動します。

  16. rootとしてログインし、podmanmgradm、およびmgradm-bash-completionをインストールします(まだ自動的にインストールされていない場合)。

    zypper install podman mgradm mgradm-bash-completion
  17. システムを再起動するか、次のコマンドを実行してPodmanサービスを起動します。

    systemctl enable --now podman.service

配備を続行するには、カスタム永続ストレージの設定を参照してください。

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

永続ストレージの設定はオプションですが、コンテナのディスクがいっぱいになった状態での深刻な問題を回避する唯一の方法です。インフラストラクチャにカスタム永続ストレージが必要な場合は、mgr-storage-proxyツールを使用してください。

詳細については、mgr-storage-proxy --helpを参照してください。このツールを使用すると、コンテナストレージとSquidキャッシュボリュームの作成が容易になります。

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

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

例:

mgr-storage-proxy /dev/nvme1n1

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

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

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

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

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

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

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

プロシージャ: プロキシホストのブートストラップ
  1. システム  ブートストラップを選択します。

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

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

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

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

  6. オペレーティングシステムがSLE Microの場合は、プロキシホストを再起動します。

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

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

  2. オペレーティングシステムがSLE Microの場合は、プロキシホストを再起動します。

7. プロキシ設定の生成

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

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

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

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

7.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キャッシュの最大許容サイズ。コンテナで使用可能なストレージの最大80%で使用することを推奨します。

    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

7.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 .

7.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 .

8. プロキシ設定の転送

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

プロシージャ: プロキシ設定をコピーする
  1. まだ実行していない場合は、前のステップで生成された設定アーカイブ (config.tar.gz)をサーバコンテナからサーバホストにコピーします。

    mgrctl cp server:/root/config.tar.gz .
  2. まだ実行していない場合は、サーバホストからプロキシホストにファイルをコピーします。

    scp config.tar.gz <proxy-FQDN>:/root
  3. プロキシホストで、次のコマンドを使用してプロキシをインストールします。

    mgrpxy install podman config.tar.gz

9. SUSE Managerプロキシの起動

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

プロシージャ: プロキシを起動してステータスを確認する
  1. 次のコマンドを呼び出してプロキシを起動します。

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

    mgrpxy status

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

    • proxy-salt-broker

    • proxy-httpd

    • proxy-tftpd

    • proxy-squid

    • proxy-ssh

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

デフォルトでは、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

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