Skip to content

Latest commit

 

History

History
316 lines (211 loc) · 20.4 KB

README0.9-jp.md

File metadata and controls

316 lines (211 loc) · 20.4 KB

バイナリ方式では、オフラインで利用可能な複数kubernetes クラスタをインストールし、タイミングインストール、kubernetes ノードの追加、kubernetes ノードの削除、kubernetes ホストの廃棄、kubernetes ホストの再構築、kubernetes クラスタのアンマウントなどをサポートします。
(目的のホストにソフトウェアをインストールする必要はなく、純粋な裸マシンがあればオフラインで高利用可能な kubernetes クラスタの配置を完了することができます。)

kube-install


English Documents | 繁体中文文档 | 简体中文文档 | 日本語の文書


[1] 互換性


互換性説明:
kube-installバージョンKubernetesバージョンオペレーティングシステム関連文書
kube-install v0.9.* kubernetes v1.28, v1.27, v1.26, v1.25, v1.24 CentOS 7 , RHEL 7, CentOS 8 , RHEL 8 , SUSE Linux 15 , Ubuntu Server 20 説明ドキュメント
構成部品構成表
kube-install v0.8.* kubernetes v1.24, v1.23, v1.22, v1.20, v1.19, v1.18 CentOS 7 , RHEL 7 , CentOS 8 , RHEL 8 , SUSE Linux 15 , Ubuntu Server 20 詳細の表示
kube-install v0.7.* kubernetes v1.23, v1.22, v1.20, v1.19, v1.18, v1.17 CentOS 7 , RHEL 7 , CentOS 8 , RHEL 8 , SUSE Linux 15 , Ubuntu Server 20 詳細の表示
kube-install v0.6.* kubernetes v1.22, v1.21, v1.20, v1.19, v1.18, v1.17, v1.16, v1.15, v1.14 CentOS 7 , RHEL 7 , CentOS 8 , RHEL 8 , SUSE Linux 15 詳細の表示
kube-install v0.5.* kubernetes v1.21, v1.20, v1.19, v1.18, v1.17, v1.16, v1.15, v1.14 CentOS 7 , RHEL 7 詳細の表示
kube-install v0.4.* kubernetes v1.21, v1.20, v1.19, v1.18, v1.17, v1.16, v1.15, v1.14 CentOS 7 , RHEL 7 詳細の表示
kube-install v0.3.* kubernetes v1.18, v1.17, v1.16, v1.15, v1.14 CentOS 7詳細の表示
kube-install v0.2.* kubernetes v1.14 CentOS 7 詳細の表示
kube-install v0.1.* kubernetes v1.14 CentOS 7 詳細の表示

注意:kube-installはCentOS 7、CentOS 8、SUSE 15、RHEL 7、RHEL 8のオペレーティングシステム環境に対応しています。ここをクリックして、kube-installがサポートするオペレーティングシステムの発行版のリストを調べます


[2] kube-installパッケージを載せます。


あなたは https://github.com/cloudnativer/kube-install/releases ここで kube-install-*.tgz ソフトパッケージをダウンロードします。
例えば kube-install-allinone-v0.9.0.tgzパッケージをダウンロードしてインストールします:

# cd /root/
# curl -O https://github.com/cloudnativer/kube-install/releases/download/v0.9.0/kube-install-allinone-v0.9.0.tgz
# tar -zxvf kube-install-allinone-v0.9.0.tgz
# cd /root/kube-install/

注意:もしあなたのローカルのネットワーク環境があまり良くないなら、断続的な継続をサポートするダウンロードソフトを使ってパッケージをダウンロードすることをお勧めします。より良いダウンロード体験を得ることができます。



[3] Webプラットフォームでkubernetesクラスタをインストールする


4台のサーバーがある場合、K8s-masterは3台のサーバー(192.168.1.11、192.168.1.12、192.168.1.13)にインストールされ、K8s-nodeは4台のサーバ(192.168.1.11、192.168.1.12、192.168.1.13、192.168.1.14)にインストールされます。サーバのオペレーティングシステムは、純粋なCentOS LinuxまたはRHEL(RedHat Enterprise Linux)であり、具体的には以下の表に示す。

IPアドレスインストールが必要なコンポーネントOSバージョンrootパスワード
192.168.1.11k8s-master,k8s-node,kube-installCentOS Linux release 7 or Red Hat Enterprise Linux(RHEL) 7cloudnativer
192.168.1.12k8s-master,k8s-nodeCentOS Linux release 7 or Red Hat Enterprise Linux(RHEL) 7cloudnativer
192.168.1.13k8s-master,k8s-nodeCentOS Linux release 7 or Red Hat Enterprise Linux(RHEL) 7cloudnativer
192.168.1.14k8s-nodeCentOS Linux release 7 or Red Hat Enterprise Linux(RHEL) 7cloudnativer
設置後の配置構造は下図のようになります。

kube-install-arch


注意:ここでは192.168.1.11をkube-installソースインストール機として使用します。実際には、任意のホスト(kubernetes クラスタ以外のホストを含む)をkube-installソースインストール機として使用することができます。

3.1 システム環境を初期化


まず、rootユーザーを使って、kube-installソースインストール機のローカル環境を初期化操作し、解凍後のソフトウェアディレクトリに入って `kube-install -init` コ> マンドを実行する必要があります:
# cd /root/kube-install/
# ./kube-install -init -ostype "centos7"

注意:kube-installソフトウェアはrhel7rhel8centos7centos8ubuntu20suse15などのバージョンのオペレーティングシステムをサポートします。初期 化操作をする時、-ostypeパラメータの設定が正しいことを確認してください。

3.2 kube-installのWeb管理サービスを実行します

その後、Webインターフェースの右上のInstall Kubernetesボタンをクリックして、Kubernetesクラスタのインストールを開始します。kube-installのWeb管理プラットフォームはSSHオン、タイミングインストール配置、Node拡張、Master修復、クラスタアンインストールなどの強力な機能を備えており、Web管理プラットフォームでより良いインストール体験を得ることができます。

# cd /root/kube-install/
# ./kube-install -init -ostype "centos7"
#
# systemctl start kube-install.service
#
# systemctl status kube-install.service
  ● kube-install.service - kube-install One click fast installation of highly available kubernetes cluster.
     Loaded: loaded (/etc/systemd/system/kube-install.service; disabled; vendor preset: disabled)
     Active: active (running) since Fri 2021-08-20 14:30:55 CST; 21min ago
       Docs: https://cloudnativer.github.io/
   Main PID: 2768 (kube-install)
     CGroup: /system.slice/kube-install.service
             └─2768 /go/src/kube-install/kube-install -daemon
   ...

この時点で、Webブラウザを使って開くことができます http://kube-installソースインストール機のIP:9080 は、kube-installのWeb管理プラットフォームにアクセスしました。 ユーザー名 admin とデフォルトパスワード CloudNativeR でログイン! (後でwebプラットフォームでパスワードを変更できます)

注意:kube-installのWeb管理プラットフォームサービスはデフォルトで TCP 9080を傍受します。この傍受アドレスを修正したいなら /etc/systemd/system/kube-install.service ファイルの kube-install -daemon -listen ip:port パラメータを修正して設定することができます。ここをクリックして詳細文書を見ることができます

3.3 Web画面にKubernetesをインストールする

その後、Webインターフェースの右上のInstall Kubernetesボタンをクリックしてkubernetesクラスタのインストールを開始します。

kube-dashboard

注意:ターゲットホストにkubernetesクラスタをインストールする前に、ターゲットホストのSSH免密チャンネルにkube-installソースインストールマシンをローカルにオンしてください。 あなたは自分で手で目標ホストのSSHチャンネルを打てばいいです。右上の Open SSH Channel of Host ボタンをクリックして打開してもいいです。ここをクリックしてもっと詳しい文書を確認できます

ポップアップの「インストールフォーム」ウィンドウに、インストールに必要なパラメータ情報を入力します。

kube-dashboard

説明:

  • インストールするKubernetesバージョンを選択してください。現在kube-installはv 1をサポートしています。17~1.24バージョンのKubernetesインストール導入、その他のバージョンのKuberneteは検証されていません。
  • インストールするCNIプラグインを選択してください。現在kube-installはFlannelCalicoKube-routerWeaveCiliumなどのCNIプラグインタイプをサポートしています。Ciliumをインストールする必要がある場合は、Linuxカーネルを4.9以降にアップグレードします。
  • オペレーティングシステム環境を選択してください。低バージョンのCentos 7RHEL 7にはカーネルモジュールが欠けている可能性があります。kube-installはCentos 7RHEL 7オペレーティングシステムカーネルに4.19に自動的にアップグレードする機能を提供しています。この機能を使用するか、オペレーティングシステムカーネルを手動で最適化するかを選択できます。

注意: タイミングインストールを設定しない場合は、デフォルトではすぐにインストールを開始します。タイミングインストールをしたい場合は、以下のタイミングインストールの日付と時間を選択することもできます。

kube-dashboard

ここをクリックして、より多くのkube-installのWeb管理プラットフォームを通じて配置の詳細を見ることができます


[4] 速やかにKubernetesクラスタをインストールする


Webプラットフォームを使用してkubernetesクラスタをインストールできるほか、kube-installのコマンドラインでkubernetesクラスタをインストールすることもできます。kube-installのコマンドラインは使いやすいです。

4.1 システム環境を初期化


まず、rootユーザーを使って、kube-installソースインストール機のローカル環境を初期化操作し、解凍後のソフトウェアディレクトリに入って `kube-install -init` コマンドを実行する必要があります:
# cd /root/kube-install/
# ./kube-install -init -ostype "centos7"

注意:kube-installソフトウェアはrhel7rhel8centos7centos8ubuntu20suse15などのバージョンのオペレーティングシステムをサポートします。初期化操作をする時、-ostypeパラメータの設定が正しいことを確認してください。

4.2 ターゲットホストへのSSHチャネル


ターゲットホストにkubernetesクラスタをインストールする前に、クビ-innstallソースのインストール機を通じて、ターゲットホストのSSH非密チャンネルにローカルに接続してください。 あなたは自分で手で目標ホストのSSH通路に通すことができます。また `kube-install -exec sshcontrol` コマンドで通してもいいです。
# cd /root/kube-install/
# ./kube-install -exec sshcontrol -sship "192.168.1.11,192.168.1.12,192.168.1.13,192.168.1.14" -sshpass "cloudnativer"

あなたもkube-installのWeb管理プラットフォームを通じてターゲットホストのSSHチャネルにアクセスできます。ここをクリックして、Web管理プラットフォームを使ってSSHチャネルを打開する方法を確認してください


4.3 ワンタッチで配置kubernetesクラスタをインストールします。


kube-installソースインストーラでrootユーザーを使用して次のコマンドを実行します。
# cd /root/kube-install/
# ./kube-install -exec install -master "192.168.1.11,192.168.1.12,192.168.1.13" -node "192.168.1.11,192.168.1.12,192.168.1.13,192.168.1.14" -k8sver "1.28" -ostype "centos7" -label "192168001011"

注意:

  • kube-installソフトウェアはrhel 7rhel 8centos7centos8ubuntu20suse15などのバージョンのオペレーティングシステムをサポートしています。セットアップ操作をする時、-ostypeパラメータの設定が正しいことを確認してください。低いバージョンのcentos 7redhat 7はカーネルモジュールが不足する可能性があるので、kube-installcentos 7rhel 7オペレーティングシステムのカーネルに対して自動的に4.19にアップグレードする機能を提供しています。この機能を使って、-upgradekernelパラメータを選択することができます。
  • あなたがインストールしたいCNIプラグインを選択してください。現在は、kube-innstallFlannelCalicoKube-routerWeaveCiliumなどのCNIプラグインタイプをサポートしています。Cliumをインストールする必要があれば、Linuxカーネルを4.9以上にアップグレードしてください。

また、Kubernetesクラスタを目的ホストにインストールするディレクトリパスをカスタマイズする必要があれば -softdir パラメータを持って設定することができます。


4.4 Kubernetes dashboard画面に登録する


loginkey.txtファイルを確認することで、kube-dashboardの登録住所と鍵を取得することができます。
# cat /opt/kube-install/loginkey.txt

loginkey

以下のスクリーンショットに示すように、kube-dashboardの登録アドレスと鍵:

kube-dashboard

kube-dashboard



[5] 拡張容量と廃棄Node|修復Master|アンインストールクラスタ


Kube-installは、単一のマシンと高利用可能なkubernetesクラスタを簡単にインストールするだけでなく、k8s-nodeの拡張と廃棄、k8s-masterの廃棄と修復、kubernetesクラスタのアンインストールなどをサポートします。
例えば、今は第[2]チャプターにインストールされたクベルkubernetesクラスタに、k8s-nodeノードを2つ追加する必要があります(192.168.1.15 and 192.168.1.16)、関連情報は以下の通りです。

IPアドレスインストールが必要なコンポーネントOSバージョンrootパスワード
192.168.1.11k8s-master,k8s-node,kube-installCentOS Linux release 7 or Red Hat Enterprise Linux(RHEL) 7cloudnativer
192.168.1.12k8s-master,k8s-nodeCentOS Linux release 7 or Red Hat Enterprise Linux(RHEL) 7cloudnativer
192.168.1.13k8s-master,k8s-nodeCentOS Linux release 7 or Red Hat Enterprise Linux(RHEL) 7cloudnativer
192.168.1.14k8s-nodeCentOS Linux release 7 or Red Hat Enterprise Linux(RHEL) 7cloudnativer
192.168.1.15k8s-nodeCentOS Linux release 7 or Red Hat Enterprise Linux(RHEL) 7cloudnativer
192.168.1.16k8s-nodeCentOS Linux release 7 or Red Hat Enterprise Linux(RHEL) 7cloudnativer

Kube-installソースホストにrootユーザを使用して以下のコマンドを実行します:

# kube-install -exec addnode -node "192.168.1.15,192.168.1.16" -k8sver "1.28" -ostype "centos7" -label "192168001011"

注意:kube-installソフトウェアはrhel7rhel8centos7centos8ubuntu20suse15などのバージョンのオペレーティングシステムをサポートします。初期化操作をする時、-ostypeパラメータの設定が正しいことを確認してください。
また、Kubernetesクラスタを目的ホストにインストールするディレクトリパスをカスタマイズする必要があれば -softdir パラメータを持って設定することができます。


設置完了後の配置構造は下図のようになります。

kube-install-arch

kube-install -exec addnodeコマンドを使用してk8s-nodeノードの拡張を行うほか、あなたも同様にkube-installのWeb管理プラットフォームを使用してk8s-nodeノードの拡張を行うことができます。Add Nodeボタンをクリックしてフォームを記入すれば、k8s-nodeの拡張が完了します。ここをクリックしてkube-installのWeb管理プラットフォームを使ってk8s-nodeノードを拡張する方法を確認できます

kube-dashboard

ウェブ端末でk8s-nodeサーバを管理するには、Enable TerminalWeb Terminalをクリックしてください。

注意:ここをクリックして、もっと多くのk8s-nodeとk8s-masterを破壊し、k8s-masterを修復し、クラスタをアンロードする操作につ> いて確認してください



[6] kube-install命令行の助け


あなたはkube-install -helpコマンドを実行して、kube-installの使用支援文書を確認してもいいです。ここをクリックして、より詳細なコマンドラインヘルプドキュメントを確認してもいいです



[7] kube-installクラスタアーキテクチャ


./data/ディレクトリは、kube-installインストールデプロイのすべてのステータス情報を格納するために使用され、すべてのkubernetesクラスタの構成などの情報が含まれます。./data/ディレクトリはファイルストレージの形式で共有され、一部の負荷等化ソフトウェアによってプライマリ・スタンバイ・スイッチングまたは負荷等化クラスタ効果を実現する。ここをクリックして、より詳細なアーキテクチャドキュメントを表示できます。

architecture



[8] IssuesとPRを提出してください

使用中に問題があったら、https://github.com/cloudnativer/kube-install/issuesIssuesを提出してもいいです。Forkソースコードを修正してBUGを修復してみて、PRを提出してください。


# git clone your-fork-code
# git checkout -b your-new-branch
# git commit -am "Fix bug or add some feature"
# git push origin your-new-branch

IssuesとPRを提出してください。
貢献者の皆様、ありがとうございます。