This documentation is for a release that is no longer maintained
See documentation for the latest supported version 3 or the latest supported version 4.第7章 非接続インストール
データセンターの一部が、プロキシーサーバー経由でもインターネットにアクセスできないことがよくあります。このような環境でも OpenShift Container Platform をインストールできますが、必要なソフトウェアおよびイメージをダウンロードし、これらを非接続環境で利用できる状態にする必要があります。
インストールコンポーネントがノードホストで利用可能な状態で、標準的なインストール手順に従って OpenShift Container Platform をインストールします。
OpenShift Container Platform をインストールしたら、プルした S2I ビルダーイメージをクラスターで利用可能にする必要があります。
7.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- OpenShift Container Platform のアーキテクチャーの概要を確認し、環境トポロジーについて計画します。
- root アクセスが可能な、インターネットにアクセスでき、110 GB 以上のディスク領域を持つ Red Hat Enterprise Linux (RHEL) 7 サーバーを取得します。このコンピューターに必要なソフトウェアリポジトリーおよびコンテナーイメージをダウンロードします。
- ミラーリングされたリポジトリーを提供するために Web サーバーを非接続環境で維持できるように計画します。インターネットに接続されたホストからこの Webサーバーに対して、ネットワーク経由か、または非接続デプロイメントで物理メディアを使用してリポジトリーをコピーします。
ソースコントロールリポジトリーを指定します。インストール後に、ノードは Git などのソースコードリポジトリーのソースコードにアクセスする必要があります。
OpenShift Container Platform でアプリケーションをビルドする場合、ビルドに Maven リポジトリーや Ruby アプリケーション用の Gem ファイルなどの外部の依存関係が含まれる可能性があります。
非接続環境内にレジストリーを指定します。オプションには以下が含まれます。
- スタンドアロン OpenShift Container Platform レジストリーのインストール
- Docker レジストリーとして動作する Red Hat Satellite 6.1 サーバーの使用
7.2. 必要なソフトウェアパッケージおよびイメージの取得 リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform を非接続環境にインストールする前に、必要なイメージおよびコンポーネントを取得し、それらをリポジトリーに保存します。
非接続環境のクラスターと同じアーキテクチャーを持つシステムで必要なイメージおよびソフトウェアコンポーネントを取得する必要があります。
7.2.1. OpenShift Container Platform パッケージの取得 リンクのコピーリンクがクリップボードにコピーされました!
インターネット接続のある RHEL 7 サーバーで、リポジトリーを同期します。
リポジトリーの同期後にパッケージが削除されないように GPG キーをインポートします。
rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release
$ rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release
Copy to Clipboard Copied! Toggle word wrap Toggle overflow サーバーを Red Hat カスタマーポータルに登録します。OpenShift Container Platform サブスクリプションにアクセスできるアカウントに関連付けられている認証情報を使用する必要があります。
subscription-manager register
$ subscription-manager register
Copy to Clipboard Copied! Toggle word wrap Toggle overflow RHSM から最新サブスクリプションデータをプルします。
subscription-manager refresh
$ subscription-manager refresh
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Container Platform チャンネルを提供するサブスクリプションをアタッチします。
OpenShift Container Platform チャンネルを提供する利用可能なサブスクリプションプールを検索します。
subscription-manager list --available --matches '*OpenShift*'
$ subscription-manager list --available --matches '*OpenShift*'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Container Platform を提供するサブスクリプションのプール ID をアタッチします。
subscription-manager attach --pool=<pool_id> subscription-manager repos --disable="*"
$ subscription-manager attach --pool=<pool_id> $ subscription-manager repos --disable="*"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
OpenShift Container Platform 3.10 で必要なリポジトリーのみを有効にします。
x86_64 サーバーでのクラウドインストールおよびオンプレミスインストールの場合は、以下のコマンドを実行します。
subscription-manager repos \ --enable="rhel-7-server-rpms" \ --enable="rhel-7-server-extras-rpms" \ --enable="rhel-7-server-ose-3.10-rpms" \ --enable="rhel-7-server-ansible-2.4-rpms"
# subscription-manager repos \ --enable="rhel-7-server-rpms" \ --enable="rhel-7-server-extras-rpms" \ --enable="rhel-7-server-ose-3.10-rpms" \ --enable="rhel-7-server-ansible-2.4-rpms"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow IBM POWER8 サーバーでのオンプレミスインストールの場合は、以下のコマンドを実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow IBM POWER9 サーバーでのオンプレミスインストールの場合は、以下のコマンドを実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
必要なパッケージをインストールします。
sudo yum -y install yum-utils createrepo docker git
$ sudo yum -y install yum-utils createrepo docker git
Copy to Clipboard Copied! Toggle word wrap Toggle overflow yum-utils
パッケージは reposync ユーティリティーを提供します。これによって yum リポジトリーをミラーリングでき、createrepo
で使用可能なyum
リポジトリーをディレクトリーから作成できます。ソフトウェアを保存するディレクトリーをサーバーのストレージまたは、USB ドライブまたは他の外部デバイスに作成します。
mkdir -p </path/to/repos>
$ mkdir -p </path/to/repos>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 重要このサーバーを接続されていない LAN に再接続し、これをリポジトリーサーバーとして使用する場合、ファイルをローカルに保存します。ローカルに保存できない場合は、USB で接続されたストレージを使用し、ソフトウェアを接続されていない LAN のリポジトリーサーバーに移動できるようにします。
パッケージを同期し、各パッケージのリポジトリーを作成します。
x86_64 サーバーでのオンプレミスインストールの場合は、以下のコマンドを実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow IBM POWER8 サーバーでのオンプレミスインストールの場合は、以下のコマンドを実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow IBM POWER9 サーバーでのオンプレミスインストールの場合は、以下のコマンドを実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.2.2. イメージの取得 リンクのコピーリンクがクリップボードにコピーされました!
必要なコンテナーイメージをプルします。
Docker デーモンを起動します。
systemctl start docker
$ systemctl start docker
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 必要な OpenShift Container Platform インフラストラクチャーコンポーネントイメージすべてをプルします。
<tag>
をインストールするバージョンに置き換えます。たとえば、最新バージョンのv3.10.45
を指定します。別のマイナーバージョンを指定することもできます。Copy to Clipboard Copied! Toggle word wrap Toggle overflow x86_64 サーバーのオンプレミスインストールの場合、以下のイメージをプルします。
<tag>
をインストールするバージョンに置き換えます。たとえば、最新バージョンのv3.10.45
を指定します。別のマイナーバージョンを指定することもできます。docker pull registry.access.redhat.com/openshift3/efs-provisioner:<tag>
$ docker pull registry.access.redhat.com/openshift3/efs-provisioner:<tag>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow オプションのコンポーネントに必要な OpenShift Container Platform コンポーネントイメージすべてをプルします。
<tag>
をインストールするバージョンに置き換えます。たとえば、最新バージョンのv3.10.45
を指定します。別のマイナーバージョンを指定することもできます。x86_64 サーバーでのオンプレミスインストールの場合は、以下のコマンドを実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow IBM POWER8 または IBM POWER9 サーバーでのオンプレミスインストールの場合は、以下のコマンドを実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
重要Red Hat サポートの場合、コンバージドモードのサブスクリプションが
rhgs3/
イメージに必要です。重要OpenShift Container Platform 上での Prometheus はテクノロジープレビュー機能です。テクノロジープレビュー機能は Red Hat の実稼働環境でのサービスレベルアグリーメント (SLA) ではサポートされていないため、Red Hat では実稼働環境での使用を推奨していません。これらの機能は、近々発表予定の製品機能をリリースに先駆けてご提供することにより、お客様は機能性をテストし、開発プロセス中にフィードバックをお寄せいただくことができます。
Red Hat のテクノロジープレビュー機能のサポートについての詳細は、https://access.redhat.com/support/offerings/techpreview/ を参照してください。
OpenShift 環境で使用する Red Hat 認定の Source-to-Image (S2I) ビルダーイメージをプルします。
バージョン番号を指定して正しいタグを使用していることを確認します。イメージバージョンの互換性についての詳細は、「OpenShift および Atomic プラットフォームのテスト済みの統合」についてのページを参照してください。
以下のイメージをプルできます。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.2.3. イメージのエクスポート リンクのコピーリンクがクリップボードにコピーされました!
ご使用の環境に内部ネットワークへのアクセスがない場合で、コンテンツの移動に物理メディアが必要になる場合、イメージを圧縮されたファイルにエクスポートします。ホストがインターネットと内部ネットワークの両方に接続されている場合、以下の手順に従い、「リポジトリーサーバーの準備および設定」に進みます。
圧縮されたイメージを保存するディレクトリーを作成し、これに切り替えます。
mkdir </path/to/images> cd </path/to/images>
$ mkdir </path/to/images> $ cd </path/to/images>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Container Platform インフラストラクチャーコンポーネントのイメージをエクスポートします。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
オプションコンポーネントのイメージを同期している場合は、それらをエクスポートします。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow プルした S2I ビルダーイメージをエクスポートします。たとえば、Jenkins および Tomcat イメージのみを同期している場合は、以下を実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 圧縮されたファイルをインターネットに接続されたホストから内部ホストにコピーします。
コピーしたイメージを読み込みます。
docker load -i ose3-images.tar docker load -i ose3-builder-images.tar docker load -i ose3-optional-images.tar
$ docker load -i ose3-images.tar $ docker load -i ose3-builder-images.tar $ docker load -i ose3-optional-images.tar
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.3. リポジトリーサーバーの準備および設定 リンクのコピーリンクがクリップボードにコピーされました!
インストール時および追加の更新時に、ソフトウェアをホストする Web サーバーが必要になります。RHEL 7 は Apache Web サーバーを提供します。
Web サーバーを準備します。
- 非接続環境に新規の Web サーバーをインストールする必要がある場合は、110 GB 以上の領域を持つ新規の RHEL 7 システムを LAN でインストールします。RHEL インストール時に、「Basic Web Server」オプションを選択します。
OpenShift Container Platform ソフトウェアをダウンロードしており、イメージが必要なサーバーを再利用している場合、Apache をサーバーにインストールします。
sudo yum install httpd
$ sudo yum install httpd
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
リポジトリーファイルを Apache のルートフォルダーに配置します。
サーバーを再利用している場合は、以下を実行します。
mv /path/to/repos /var/www/html/ chmod -R +r /var/www/html/repos restorecon -vR /var/www/html
$ mv /path/to/repos /var/www/html/ $ chmod -R +r /var/www/html/repos $ restorecon -vR /var/www/html
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 新規サーバーをインストールしている場合、外部ストレージを割り当ててから、ファイルをコピーします。
cp -a /path/to/repos /var/www/html/ chmod -R +r /var/www/html/repos restorecon -vR /var/www/html
$ cp -a /path/to/repos /var/www/html/ $ chmod -R +r /var/www/html/repos $ restorecon -vR /var/www/html
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
ファイアウォールのルールを追加します。
sudo firewall-cmd --permanent --add-service=http sudo firewall-cmd --reload
$ sudo firewall-cmd --permanent --add-service=http $ sudo firewall-cmd --reload
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 変更を有効にするには、Apache を有効にしてから起動します。
systemctl enable httpd systemctl start httpd
$ systemctl enable httpd $ systemctl start httpd
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.4. レジストリーの設定 リンクのコピーリンクがクリップボードにコピーされました!
非接続環境でイメージにタグを付け、そのイメージを内部レジストリーにプッシュします。
以下の手順では、イメージをレジストリーに読み込む方法についての概要を示します。イメージを読み込む際に、追加の、または異なるアクションを実行する必要がある可能性があります。
イメージをレジストリーにプッシュする前に、それぞれのイメージに再度タグを付けます。
openshift3
リポジトリーのイメージについては、イメージにメジャーおよびマイナー番号の両方のタグを付けます。たとえば、OpenShift Container Platform ノードイメージにタグを付けるには、以下を実行します。docker tag registry.access.redhat.com/openshift3/ose-node:<tag> registry.example.com/openshift3/ose-node:<tag> docker tag registry.access.redhat.com/openshift3/ose-node:<tag> registry.example.com/openshift3/ose-node:{major-tag}
$ docker tag registry.access.redhat.com/openshift3/ose-node:<tag> registry.example.com/openshift3/ose-node:<tag> $ docker tag registry.access.redhat.com/openshift3/ose-node:<tag> registry.example.com/openshift3/ose-node:{major-tag}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 他のイメージについては、イメージに完全に一致するバージョン番号のタグを付けます。たとえば、etcd イメージにタグを付けるには、以下を実行します。
docker tag registry.access.redhat.com/rhel7/etcd:3.2.22 registry.example.com/rhel7/etcd:3.2.22
$ docker tag registry.access.redhat.com/rhel7/etcd:3.2.22 registry.example.com/rhel7/etcd:3.2.22
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
各イメージをレジストリーにプッシュします。たとえば、OpenShift Container Platform ノードイメージをプッシュするには、以下を実行します。
docker push registry.example.com/openshift3/ose-node:<tag> docker push registry.example.com/openshift3/ose-node:{major-tag}
$ docker push registry.example.com/openshift3/ose-node:<tag> $ docker push registry.example.com/openshift3/ose-node:{major-tag}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.5. クラスターホストの準備 リンクのコピーリンクがクリップボードにコピーされました!
インストールファイルを準備したら、次にホストを準備します。
- OpenShift Container Platform クラスターのホストを作成します。最新バージョンの RHEL 7 を使用し、最小インストールを実行することが推奨されます。ホストがシステム要件を満たしていることを確認します。
各ノードホストで、リポジトリー定義を作成します。以下のテキストを /etc/yum.repos.d/ose.repo ファイルに配置します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ホストのインストールを準備します。「ホストの準備」の手順に従い、「ホスト登録」のセクションの手順は省略します。
7.6. OpenShift Container Platform のインストール リンクのコピーリンクがクリップボードにコピーされました!
ソフトウェア、イメージおよびホストを準備したら、標準的なインストール方法を使用して OpenShift Container Platform をインストールします。
内部レジストリーを参照するようにインベントリーファイルを設定します。
orge_url=registry.example.com/openshift3/ose-${component}:${version} openshift_examples_modify_imagestreams=true
orge_url=registry.example.com/openshift3/ose-${component}:${version} openshift_examples_modify_imagestreams=true
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - インストール Playbook の実行