Faq
faq.md# よくある質問
1 初回インストールで問題が発生した場合、クリーンアップ後に再インストールするにはどうすればよいですか?¶
注意:対象となるのは、初回インストール時に問題が発生し、すべて削除して再インストールする必要がある場合のみです。以下のクリーンアップ手順を実行する前に、内容をよく確認してください。
インストールで問題が発生し、すべて削除して再インストールする必要がある場合、以下の 3 か所をクリーンアップして初めて、Launcher から Guance を再インストールできます。
1.1 インストール済みの Guance アプリケーションサービスをクリーンアップ¶
Kubernetes にインストールされている各種 Guance アプリケーションサービスをクリーンアップするには、運用保守用の操作マシンで Launcher コンテナに入り、Launcher に付属のクリーンアップスクリプトを実行します。
launcher-xxxxxxxx-xxx は、お使いの launcher サービス Pod の名前です。
コンテナに入ると、Launcher サービスに付属の k8s-clear.sh スクリプト(1.47.103 以降のバージョンでは、このスクリプトは /config/tools ディレクトリにあります)を確認できます。このスクリプトを実行すると、すべての Guance アプリケーションサービスと Kubernetes リソースがクリーンアップされます。
1.2 MySQL に自動作成されたデータベースをクリーンアップ¶
Launcher コンテナに入ります。Launcher コンテナには mysql クライアントツールが同梱されているため、以下のコマンドを使用して Guance の MySQL インスタンスに接続します。
mysql 管理者アカウントで接続する必要があります。接続後、以下の 6 つの MySQL データベースとユーザーのクリーンアップコマンドを実行します。
drop database df_core;
drop user df_core;
drop database df_message_desk;
drop user df_message_desk;
drop database df_func;
drop user df_func;
drop database df_dialtesting;
drop user df_dialtesting;
1.3 InfluxDB に自動作成されたユーザーをクリーンアップ¶
時系列エンジンに InfluxDB を使用している場合は、influx クライアントツールで InfluxDB に接続し、以下の 2 つのユーザークリーンアップコマンドを実行します。
2 デプロイ時の注意事項¶
2.1 デプロイ完了後、インストーラーが自動生成した Kubernetes リソースを手動で変更できますか?¶
手動での変更はできません。 次回の新バージョンリリース後に Launcher を使用してアップグレードインストールを行うと、インストール時に入力した構成情報に基づいて Deployment、Service、Ingress などのリソースが再生成されるためです(Configmap は除きます。Configmap の構成項目の情報は任意に手動変更できますが、不適切に変更するとプログラムの実行に異常が発生する可能性があります)。
3 スタンドアロンコンテナの Rancher Server 証明書更新¶
3.1 証明書が有効期限内の場合の対応¶
rancher server は正常に実行できます。Rancher v2.0.14+、v2.1.9+、v2.2.2+ にアップグレードすると、証明書の有効期限が自動的にチェックされます。証明書が間もなく期限切れになることが検出された場合は、新しい証明書が自動生成されます。そのため、スタンドアロンコンテナで実行されている Rancher Server は、証明書の期限切れ前に rancher バージョンを SSL 証明書の自動更新に対応したバージョンにアップグレードするだけで済み、他の操作は不要です。
3.2 証明書が期限切れの場合の対応¶
rancher server は正常に実行できません。Rancher v2.0.14+、v2.1.9+、v2.2.2+ にアップグレードしても、証明書エラーが表示される場合があります。このような場合は、以下の操作で対応できます。
-
rancher バージョンを v2.0.14+、v2.1.9+、v2.2.2+ に正常にアップグレードします。
-
以下のコマンドを実行します。
-
2.0 または 2.1 バージョン
docker exec -ti <rancher_server_id>mv /var/lib/rancher/management-state/certs/bundle.json /var/lib/rancher/management-state/certs/bundle.json-bak
- 2.2 以降
docker exec -ti <rancher_server_id>mv /var/lib/rancher/management-state/tls/localhost.crt /var/lib/rancher/management-state/tls/localhost.crt-bak
- 2.3 以降
docker exec -ti <rancher_server_id>mv /var/lib/rancher/k3s/server/tls /var/lib/rancher/k3s/server/tlsbak
# 2回実行します。1回目は証明書の申請用、2回目は証明書のロードと起動用です
docker restart <rancher_server_id>
- 2.4 以降
a. rancher server に exec します
kubectl --insecure-skip-tls-verify -n kube-system delete secrets k3s-serving
kubectl --insecure-skip-tls-verify delete secret serving-cert -n cattle-system
rm -f /var/lib/rancher/k3s/server/tls/dynamic-cert.json
b. rancher-server を再起動します
c. 以下のコマンドを実行してパラメータを更新します
- Rancher Server コンテナを再起動します
4 rancher server の証明書が期限切れで Kubernetes クラスターを管理できなくなった場合の対応¶
クラスターの証明書がすでに期限切れの場合、Rancher v2.0.14、v2.1.9 以降のバージョンにアップグレードしても、証明書をローテーションすることはできません。rancher は Agent を介して証明書を更新するため、証明書が期限切れになると Agent に接続できません。
4.1 解決方法¶
ノードの時刻を手動で設定し、少し過去の時刻に調整します。Agent は K8S master と Rancher Server とのみ通信するため、Rancher Server の証明書が期限切れでない場合は、K8S master ノードの時刻を調整するだけで済みます。
調整コマンド:
# NTP 同期を無効にします。無効にしないと時刻が自動的に更新されます
timedatectl set-ntp false
# ノードの時刻を変更します
timedatectl set-time '2019-01-01 00:00:00'
その後、Rancher Server をアップグレードし、証明書のローテーションが完了したら時刻の同期を元に戻します。
証明書の有効期限を確認します。
5 DataWay を作成したのにフロントエンドに表示されないのはなぜですか?¶
5.1 よくある原因の分析¶
- Dataway サービスがサーバーにデプロイされた後、正常に実行されていません。
- Dataway サービスの構成ファイルが誤っており、正しいリスニング設定とワークスペーストークン情報が設定されていません。
- Dataway サービスの実行構成が誤っています。詳細は dataway のログを確認して特定できます。
- Dataway をデプロイしたサーバーが kodo サービスと通信できません。(dataway サーバーの hosts に df-kodo サービスの正しい名前解決が追加されていない場合も含みます)
- kodo サービスに異常があります。詳細は kodo サービスのログで確認できます。
- df-kodo ingress サービスが正しく構成されていません。具体的には
http|https://df-kodo.<xxxx>:<port>にアクセスできないという症状が発生します。
6 Synthetic テストサービスを使用できないのはなぜですか?¶
6.1 原因の分析¶
- デプロイされた Guance アプリケーションがオフライン環境であり、物理ノードのネットワーク環境が外部ネットワークに接続できません。(比較的よく見られる原因です)
- セルフホストのプローブノードのネットワークに異常があります。
- 地域のプロバイダーネットワークに異常があります。
- Synthetic テストの作成設定が誤っています。
7 デプロイのよくある問題と解決方法¶
7.1 describe pods で unbound immediate PersistentVolumeClaims エラーが発生する場合¶
- pvc を確認します
NAMESPACE NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE
default opensearch-single-opensearch-single-0 Bound pvc-0da2cb6f-1cb9-4630-b0ab-512ce57743a8 16Gi RWO openebs-hostpath 19d
launcher persistent-data Pending df-nfs-storage 6m3s
middleware data-es-cluster-0 Bound pvc-36e48f5a-37b3-4c28-ad14-059265ee3009 50Gi RWO openebs-hostpath 18d
persistent-data のステータスが Pending であることが確認できます。
- nfs-subdir-external-provisioner コンテナのステータスを確認します
kubectl get pods -n kube-system | grep nfs-subdir-external-provisioner
nfs-provisioner-nfs-subdir-external-provisioner-58b7cdf6f5dr5vr 0/1 ContainerCreating 0 7h7m
nfs-provisioner-nfs-subdir-external-provisioner-58b7cdf6f5dr5vrの情報を確認します
kubectl describe -n kube-system pods nfs-provisioner-nfs-subdir-external-provisioner-58b7cdf6f5dr5vr
....
Type Reason Age From Message
---- ------ ---- ---- -------
Warning FailedMount 30m (x49 over 6h53m) kubelet Unable to attach or mount volumes: unmounted volumes=[nfs-subdir-external-provisioner-root], unattached volumes=[kube-api-access-5p4qn nfs-subdir-external-provisioner-root]: timed out waiting for the condition
Warning FailedMount 5m27s (x136 over 7h4m) kubelet Unable to attach or mount volumes: unmounted volumes=[nfs-subdir-external-provisioner-root], unattached volumes=[nfs-subdir-external-provisioner-root kube-api-access-5p4qn]: timed out waiting for the condition
Warning FailedMount 74s (x217 over 7h6m) kubelet MountVolume.SetUp failed for volume "nfs-subdir-external-provisioner-root" : mount failed: exit status 32
Mounting command: mount
Mounting arguments: -t nfs 10.200.14.112:/nfsdata /var/lib/kubelet/pods/3970ff5f-5dbf-419e-a6af-3080508d2524/volumes/kubernetes.io~nfs/nfs-subdir-external-provisioner-root
Output: mount: wrong fs type, bad option, bad superblock on 10.200.14.112:/nfsdata,
missing codepage or helper program, or other error
(for several filesystems (e.g. nfs, cifs) you might
need a /sbin/mount.<type> helper program)
In some cases useful info is found in syslog - try
dmesg | tail or so.
wrong fs type, bad option の原因は、nfs-utils がインストールされていないためです。
nfs-utilsをインストールします
ホストで以下のコマンドを実行します: