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として( |
正常に配備するには、次のアクションを実行します。
-
ハードウェア要件を確認します。
-
SLE Micro 5.5またはSUSE Linux Enterprise Server 15 SP6の親チャンネルとサーバ上のプロキシ拡張機能の子チャンネルを同期します。
-
ベアメタルマシンにSLE MicroまたはSUSE Linux Enterprise Serverをインストールします。
-
インストール時に、SLE MicroまたはSUSE Linux Enterprise ServerをSUSE Managerプロキシ拡張機能とともに登録します。
-
Saltのアクティベーションキーを作成します。
-
デフォルト
接続メソッドを使用して、プロキシをクライアントとしてブートストラップします。 -
プロキシ設定を生成します。
-
サーバからプロキシにプロキシ設定を転送します。
-
プロキシ設定を使用して、クライアントをSUSE Managerにプロキシとして登録します。
プロキシコンテナホストでサポートされるオペレーティングシステム
コンテナホストでサポートされているオペレーティングシステムはSLE Micro 5.5とSUSE Linux Enterprise Server 15 SP6です。
|
1. プロキシのハードウェア要件
SUSE Managerプロキシを配備するためのハードウェア要件の詳細については、installation-and-upgrade:hardware-requirements.adoc#proxy-hardware-requirementsを参照してください。
2. 親とプロキシ拡張機能の子チャンネルの同期
このセクションは、サーバのWeb UIのProxy
as an extension (プロキシを子チャンネルとして)]オプションを選択した状態で、サーバ上で完全に同期する必要があります。
-
SUSE ManagerのWeb UIで、
を選択します。 -
[製品]ページから、フィルタフィールドに「SLE Micro」または「SUSE Linux Enterprise Server」を入力します。
-
続いて、ドロップダウンを使用して必要なアーキテクチャを選択します。この例では、[x86-64]を選択します。
-
製品説明
フィールドで[SLE Micro 5.5 ]または[ SUSE Linux Enterprise Server 15 SP6]チェックボックスをオンにし、ドロップダウンを使用してSUSE Manager Proxy Extension 5.0 x86_64
拡張機能を選択します。 -
製品の追加をクリックします。
-
同期が完了するまで待ちます。
3. SUSE Managerプロキシホストの準備
以下のサブセクションで、SLE MicroまたはSUSE Linux Enterprise Serverを使用してプロキシホストを準備します。
3.1. SLE Micro 5.5ホストの準備
3.1.1. インストールメディアのダウンロード
-
https://www.suse.com/download/sle-micro/でSLE Micro 5.5のインストールメディアを見つけます。
-
SLE-Micro-5.5-DVD-x86_64-GM-Media1.iso
をダウンロードします。 -
インストール用のDVDまたはUSBフラッシュドライブ(ダウンロードした
.iso
イメージを含む)を準備します。
3.1.2. SLE Micro 5.5のインストール
マシン(仮想または物理)の準備の詳細については、SLE Micro 5.5 Deployment Guideを参照してください。
-
SLE Micro 5.5のインストールイメージを含むDVDまたはUSBフラッシュドライブ(USBディスクまたはキー)を挿入します。
-
システムをブートまたは再起動します。
-
矢印キーを使用して
インストール
を選択します。 -
キーボードと言語を調整します。
-
チェックボックス
をクリックしてライセンス契約に同意します。 -
次へ
をクリックして続行します。 -
登録方法を選択します。この例では、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エンタイトルメントに含まれているため、別途登録コードは必要ありません。
-
-
SUSE Customer Centerの電子メールアドレスを入力します。
-
SLE Micro 5.5の登録コードを入力します。
-
次へ
をクリックして続行します。 -
プロキシをインストールするにはSUSE Manager 5.0プロキシ拡張機能、サーバをインストールするにはSUSE Manager 5.0サーバ拡張機能の
チェックボックス
を選択します。 -
次へ
をクリックして続行します。 -
SUSE Manager 5.0拡張機能の登録コードを入力します。
-
次へをクリックして続行します。
-
NTP設定
ページで、次へをクリックします。 -
Authentication for the System (システムの認証)
ページで、rootユーザのパスワードを入力します。Click 次へをクリックします。 -
インストール設定
ページで、インストールをクリックします。
これで、拡張機能としての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アーキテクチャを登録する場合は、正しい登録コードを使用してください。 |
-
次のコマンドで利用可能な拡張機能を一覧表示します。
transactional-update --quiet register --list-extensions
-
利用可能な拡張機能のリストから、インストールしたい拡張機能を選択します。
-
サーバをインストールする場合は、次のコマンドで SUSE Manager Server Extension 5.0 x86_64の登録コードを使用します。
transactional-update register -p SUSE-Manager-Server/5.0/x86_64 -r <reg_code>
-
プロキシをインストールする場合は、次のコマンドでSUSE Manager Proxy Extension 5.0 x86_64の登録コードを使用します。
transactional-update register -p SUSE-Manager-Proxy/5.0/x86_64 -r <reg_code>
-
-
再起動します。
3.1.4. システムの更新
-
rootとしてログインします。
-
transactional-updateを実行します。
transactional-update
-
再起動します。
SLE Microはデフォルトで自動的に自己更新するように設定されており、更新が適用されると再起動します。ただし、この動作はSUSE Manager環境では望ましくありません。サーバの自動更新を防ぐために、SUSE Managerでは、ブートストラッププロセス中にトランザクション更新タイマーが無効化されます。 SLE Microのデフォルトの動作を使用したい場合は、次のコマンドを実行してタイマーを有効にします。
|
配備を続行するには、カスタム永続ストレージの設定を参照してください。
3.2. SUSE Linux Enterprise Server 15 SP6ホストの準備
または、SUSE ManagerをSUSE Linux Enterprise Server 15 SP6に配備することもできます。
次のプロシージャでは、インストールプロセスの主なステップについて説明します。
-
https://www.suse.com/download/sles/でSUSE Linux Enterprise Server 15 SP6
.iso
を見つけてダウンロードします。 -
ホストオペレーティングシステム(SUSE Linux Enterprise Server 15 SP6)と拡張機能の両方の登録コードがあることを確認します。
-
SUSE Linux Enterprise Server 15 SP6のインストールを開始します。
-
Language, Keyboard and Product Selection
(言語、キーボードおよび製品の選択)で、インストールする製品を選択します。 -
ライセンス契約
で契約を読み、[I Agree to the License Terms
( ライセンス条項に同意します)にチェックを付けます。
-
-
登録方法を選択します。この例では、SUSEカスタマーセンターにサーバを登録します。
-
SUSE Customer Centerの電子メールアドレスを入力します。
-
SUSE Linux Enterprise Server 15 SP6の登録コードを入力します。
-
次へ
をクリックして続行します。SUSE Linux Enterprise Server 15 SP6をご利用いただくには、有効なSUSE Linux Enterprise Serverサブスクリプションと対応する登録コードが必要です。これらの情報をこの画面に入力する必要があります。以下にSUSE Manager拡張機能の登録コードを入力する必要があります。
-
拡張とモジュールの選択
で、以下にチェックを付けます。-
サーバをインストールするにはSUSE Managerサーバ拡張機能を選択し、プロキシをインストールするにはSUSE Managerプロキシ拡張機能を選択します。
-
ベースシステムモジュール
-
Containersモジュール
-
-
次へ
をクリックして続行します。 -
SUSE Manager 5.0拡張機能の登録コードを入力します。
-
次へをクリックして続行します。
-
インストールを完了します。
-
インストールが完了したら、rootとして新しくインストールしたサーバにログインします。
-
システムを更新します(オプション。インストール時にシステムが更新をダウンロードするように設定されていない場合)。
zypper up
-
再起動します。
-
rootとしてログインし、
podman
、mgradm
、およびmgradm-bash-completion
をインストールします(まだ自動的にインストールされていない場合)。zypper install podman mgradm mgradm-bash-completion
-
システムを再起動するか、次のコマンドを実行して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
このコマンドは、 詳細については、以下を参照してください。 |
5. プロキシのアクティベーションキーの作成
-
に移動し、キーの作成をクリックします。
-
SLE Micro 5.5またはSUSE Linux Enterprise Server 15 SP6を親チャンネルとして使用して、プロキシホストのアクティベーションキーを作成します。このキーには、推奨されるすべてのチャンネルと、拡張機能としてのプロキシの子チャンネルが含まれる必要があります。
-
続行して、プロキシホストを
デフォルト
クライアントとしてブートストラップします。
6. クライアントとしてのプロキシホストのブートストラップ
-
を選択します。
-
プロキシホストのフィールドに入力します。
-
ドロップダウンから、前のステップで作成したアクティベーションキーを選択します。
-
Click ブートストラップをクリックします。
-
ブートストラッププロセスが完了するまで待ちます。Saltメニューをチェックし、Saltキーが一覧表示されていて受け入れられていることを確認します。
-
オペレーティングシステムがSLE Microの場合は、プロキシホストを再起動します。
-
すべてのイベントが終了したら、SLE Microの場合はシステムの一覧からホストを選択して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で、
に移動し、必要なデータを入力します。 -
[
プロキシFQDN
]フィールドに、プロキシの完全修飾ドメイン名を入力します。 -
[
親FQDN
]フィールドに、SUSE Managerサーバまたは別のSUSE Managerプロキシの完全修飾ドメイン名を入力します。 -
[
プロキシSSHポート
]フィールドに、SSHサービスがSUSE ManagerプロキシでリスンしているSSHポートを入力します。デフォルトの8022を維持することをお勧めします。 -
[
Squidの最大キャッシュサイズ[MB]
]フィールドタイプで、Squidキャッシュの最大許容サイズ。コンテナで使用可能なストレージの最大80%で使用することを推奨します。2 GBはプロキシSquidのデフォルトのキャッシュサイズを表します。これは、環境に合わせて調整する必要があります。
[SSL証明書
]選択リストで、SUSE Managerプロキシ用に新しいサーバ証明書を生成するか、既存のサーバ証明書を使用するかを選択します。 生成された証明書は、SUSE Manager組み込みの(自己署名)証明書とみなすことができます。
+ 選択に応じて、新しい証明書を生成するための署名CA証明書へのパス、またはプロキシ証明書として使用される既存の証明書とそのキーへのパスのいずれかを指定します。
+
サーバによって生成されたCA証明書は、/var/lib/containers/storage/volumes/root/_data/ssl-build
ディレクトリに保存されます。
+ 既存の証明書またはカスタム証明書、および企業証明書と中間証明書の概念の詳細については、SSL証明書のインポートを参照してください。
-
生成をクリックして、SUSE Managerサーバに新しいプロキシFQDNを登録し、コンテナホストの詳細を含む設定アーカイブ(
config.tar.gz
)を生成します。 -
しばらくすると、ダウンロードするファイルが表示されます。このファイルをローカルに保存します。

7.2. spacecmdと自己署名証明書を使用したプロキシ設定ファイルの生成
spacecmd
を使用してプロキシ設定を生成できます。
-
SSHでコンテナホストに接続します。
-
次のコマンドを実行してサーバとプロキシ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'
-
生成された設定をサーバコンテナからコピーします。
mgrctl cp server:/tmp/config.tar.gz .
7.3. spacecmdとカスタム証明書を使用したプロキシ設定の生成
デフォルトの自己署名証明書ではなくカスタム証明書に対してspacecmd
を使用して、プロキシ設定を生成できます。
-
サーバコンテナホストにSSHで接続します。
-
次のコマンドを実行してサーバとプロキシ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'
-
生成された設定をサーバコンテナからコピーします。
mgrctl cp server:/tmp/config.tar.gz .
8. プロキシ設定の転送
Web UIによって設定アーカイブが生成されます。このアーカイブをプロキシコンテナホストで利用できるようにする必要があります。
-
まだ実行していない場合は、前のステップで生成された設定アーカイブ (
config.tar.gz
)をサーバコンテナからサーバホストにコピーします。mgrctl cp server:/root/config.tar.gz .
-
まだ実行していない場合は、サーバホストからプロキシホストにファイルをコピーします。
scp config.tar.gz <proxy-FQDN>:/root
-
プロキシホストで、次のコマンドを使用してプロキシをインストールします。
mgrpxy install podman config.tar.gz
9. SUSE Managerプロキシの起動
mgrpxy
コマンドを使用してコンテナを起動できます。
-
次のコマンドを呼び出してプロキシを起動します。
mgrpxy start
-
次のコマンドを呼び出してコンテナのステータスを確認します。
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
このコマンドは、すべてのサービスの設定をグローバルデフォルトにリセットして再ロードします。