Developerは、ソースリポジトリ、ビルドとデプロイ、Image Registryなどを使用してアプリケーションを開発します。
kubectl Command 使用する
kubectlは、Kubernetesに接続してアプリケーションのデプロイ、設定など、さまざまな動作を実行する命令です。
この資料では、Windows環境でbinary方式でインストールする方法について説明します。
環境固有のkubectlをインストールする方法は、下記の公式サイトを参照してください。
取付手順および詳細手順は下記の内容をご参照ください。
- kubectlファイルを保存するディレクトリを作成する
- kubectl実行ファイルのダウンロード
- Kubernetes接続設定用の環境設定ファイルのダウンロード
- グローバル環境変数の設定
- kubectl実行ファイルパスPATH設定に追加する
- 環境設定ファイル グローバル環境変数に登録する
フォローする
kubectlファイルを保存するディレクトリを作成する
実行ファイルを保存するディレクトリ(フォルダ)をウィンドウエクスプローラを実行して作成します。
- パス
- C:\kube
kubectl実行ファイルのダウンロード
以下のリンクを使用して、kubectl.exe実行可能ファイルを最初に作成したc:\ kubeフォルダにダウンロードします。
- kubectl v1.11.0
- kubectl v1.13.0
cmdウィンドウを開き、c:\ kubeフォルダに移動してkubectl versionコマンドを確認します。
c:\> cd c:\kube c:\kube> kubectl version Client Version: version.Info{Major:"1", Minor:"13", GitVersion:"v1.13.0", GitCommit:"ddf47ac13c1a9483ea035a79cd7c10005ff21a6d", GitTreeState:"clean", BuildDate:"2018-12-03T21:04:45Z", GoVersion:"go1.11.2", Compiler:"gc", Platform:"windows/amd64"} # 서버 연결설정이 되어 있지 않으면 아래와 같이 오류 메시지가 발생 Unable to connect to the server: dial tcp [::1]:8080: connectex: No connection could be made because the target machine actively refused it.
Kubernetes接続設定用の環境設定ファイルのダウンロード
ZCPクラスタにインストールしたkubectlを利用して接続するには、クラスタサーバ情報、認証トークンなどの関連設定が必要です。その値はKubernetes設定ファイルで管理されます。
これらの接続設定はCloudZ CPコンソールからダウンロードできます。右上のユーザー名をクリックすると、表示されるドロップダウンリストからCLI Commandを選択します。
CLI Command画面で、ステップ2のダウンロードボタンをクリックします。
ファイル名を kube.conf ファイルに変更し、c:\kube フォルダーにダウンロードします。
ダウンロードした kube.conf ファイルを使って kubectl コマンドを実行するには、以下のようにコマンドを利用できます。
c:\> cd c:\kube # 설정 파일 사용 여부 설정 c:\kube> set KUBECONFIG=c:\kube\kube.conf c:\kube> kubectl version Client Version: version.Info{Major:"1", Minor:"13", GitVersion:"v1.13.0", GitCommit:"ddf47ac13c1a9483ea035a79cd7c10005ff21a6d", GitTreeState:"clean", BuildDate:"2018-12-03T21:04:45Z", GoVersion:"go1.11.2", Compiler:"gc", Platform:"windows/amd64"} # 서버 연결이 되면 아래 서버 버전 정보가 표시됩니다. Server Version: version.Info{Major:"1", Minor:"11", GitVersion:"v1.11.10+IKS", GitCommit:"7b8624d43d0e5341ae55537998cddb865607059c", GitTreeState:"clean", BuildDate:"2019-05-08T19:47:50Z", GoVersion:"go1.10.8", Compiler:"gc", Platform:"linux/amd64"}
활성화 하기 위해 set KUBECONFIG=c:\kube\kube.conf 명령을 수행합니다. 이 명령은 cmd 창을 새로 열 때마다 수행해야만 합니다.
kubectl version을 사용하여 클라이언트와 서버 정보가 정상적으로 출력되는지 확인합니다.
グローバル環境変数の設定
Window環境でどの場所でも使用できるように、PATH環境変数にディレクトリを登録する必要があります。そして、以前に受け取ったkube.confファイルをグローバル環境変数に登録すると、追加設定なしでコマンドをすぐに使用できます。
- PATHは、オペレーティングシステムがコマンドラインまたはターミナルウィンドウで必要な実行可能ファイルを見つけるために使用するシステム変数です。
- 値は、上記で作成した kubectl 実行場所 (c:\kube) を追加します。
- KUBECONFIGは、kubectlコマンドの実行時に必要なkubernetes環境設定ファイルの場所のシステム変数です。
- 値は、kube.confファイル名を含む場所(c:¥kube¥kube.conf)に設定します。
設定方法は、オペレーティングシステムのバージョンごとに以下の方法に従って行ってください。
Windows 10 と Windows 8
- [検索]でシステム(コントロールパネル)を検索して選択します。
- 高度なシステム設定リンクをクリックします。
- 環境変数をクリックします。 「システム変数」セクションで、PATH環境変数を見つけて選択します。編集をタップします。 PATH 環境変数が存在しない場合は、新規をクリックします。
- システム変数の編集(または新しいシステム変数)ウィンドウで、PATH環境変数の値を指定します。 OKを押します。 [OK]をクリックして残りのウィンドウをすべて閉じます。
- コマンドプロンプトウィンドウを再度開き、kubectlコードを実行します。
Windows 7
- 바탕 화면에서 컴퓨터 아이콘을 마우스 오른쪽 단추로 누릅니다.
- 상황에 맞는 메뉴에서 속성을 선택합니다.
- 고급 시스템 설정 링크를 누릅니다.
- 환경 변수를 누릅니다. 시스템 변수 섹션에서
PATH
환경 변수를 찾아 선택합니다. 편집을 누릅니다.PATH
환경 변수가 존재하지 않을 경우새로 만들기
를 누릅니다. - 시스템 변수 편집(또는 새 시스템 변수) 창에서
PATH
환경 변수의 값을 지정합니다. 확인을 누릅니다. 확인을 눌러 나머지 창을 모두 닫습니다. - 명령 프롬프트 창을 다시 열고 kubectl 코드를 실행합니다.
Windows XP
- 시작, 제어판을 차례로 선택합니다. 시스템을 두 번 누르고 고급 탭을 선택합니다.
- 환경 변수를 누릅니다. 시스템 변수 섹션에서
PATH
환경 변수를 찾아 선택합니다. 편집을 누릅니다.PATH
환경 변수가 존재하지 않을 경우새로 만들기
를 누릅니다. - 시스템 변수 편집(또는 새 시스템 변수) 창에서
PATH
환경 변수의 값을 지정합니다. 확인을 누릅니다. 확인을 눌러 나머지 창을 모두 닫습니다.
ソースリポジトリにソースをアップロードする
Gitea統合ログイン設定
サイドメニューで、DevOps>ソースストアをクリックします。
下の画面で最初の1回、ソースリポジトリに会員登録をします。今後別途ログインせずに接続が可能です
パスワードはPushなどのリポジトリ活用時に使用されるため、紛失しないように注意してください。
会員登録が完了したら、OpenId Connectイメージをクリックしてログインします。
使い方はGithubに似ており、Web画面から直接ファイルを作成したり、ローカルにチェックアウトして作業したりできます。
ビルドログを見る
プッシュされたソースコードは、Pipeline(Jenkins)を介してKubernetesクラスタにデプロイされます。
ビルド/デプロイプロセスはCI / CD Managerによって行われますが、ソースコードによってビルド/デプロイ中にエラーが発生する可能性があります。
このような場合は、以下の方法で Pipeline の実行ログを確認できます。
Z CP Console> DevOps>ビルドとデプロイをクリックしてJenkinsに移動し、参照権限を持つ名前空間のフォルダを表示します。
確認したい名前空間フォルダ>ビルドジョブをクリックします。
画面左側のBuild Historyでビルド実行履歴を確認でき、ビルド番号左側のアイコンをクリックするとビルドログを表示できます。
Podログを見る
ビルド/デプロイが完了すると、kubernetesにアプリケーションがデプロイされます。
デプロイされたアプリケーションをテスト/サービスする過程で、ログ、デプロイされた設定を確認する過程が必要になります。
デプロイされたアプリケーションは、PodというKubernetes内部リソースによって管理されます。
まずkubectl get pod -n (名前空間名)コマンドでログを確認したいPodの名前を確認します。
kubectl logs (Pod name) -n (namespace name) コマンドを実行してログを確認します
最初に出力される行数を指定するには、--tail =(line数)オプションを使用します。
継続的に出力されるログを確認したい場合は、-fオプションを使用してください。
その他のオプションとその詳細な説明は、kubectl --help コマンドで確認します。
オンライン相談
問い合わせ