コンテンツにスキップ

Faq

faq.md# よくある質問

1 初回インストールで問題が発生した場合、クリーンアップ後に再インストールするにはどうすればよいですか?

注意:対象となるのは、初回インストール時に問題が発生し、すべて削除して再インストールする必要がある場合のみです。以下のクリーンアップ手順を実行する前に、内容をよく確認してください。

インストールで問題が発生し、すべて削除して再インストールする必要がある場合、以下の 3 か所をクリーンアップして初めて、Launcher から Guance を再インストールできます。

1.1 インストール済みの Guance アプリケーションサービスをクリーンアップ

Kubernetes にインストールされている各種 Guance アプリケーションサービスをクリーンアップするには、運用保守用の操作マシンで Launcher コンテナに入り、Launcher に付属のクリーンアップスクリプトを実行します。

kubectl exec -it launcher-xxxxxxxx-xxx -n launcher /bin/bash

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 -h <MySQL インスタンスのホスト> -u root -P <MySQL ポート> -p  

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 つのユーザークリーンアップコマンドを実行します。

drop user user_wr;
drop user user_ro;

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+ にアップグレードしても、証明書エラーが表示される場合があります。このような場合は、以下の操作で対応できます。

  1. rancher バージョンを v2.0.14+、v2.1.9+、v2.2.2+ に正常にアップグレードします。

  2. 以下のコマンドを実行します。

  3. 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 を再起動します

docker restart <rancher_server_id>

c. 以下のコマンドを実行してパラメータを更新します

curl --insecure -sfL https://server-url/v3
  1. Rancher Server コンテナを再起動します
docker restart <rancher_server_id>

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 をアップグレードし、証明書のローテーションが完了したら時刻の同期を元に戻します。

timedatectl set-ntp true

証明書の有効期限を確認します。

openssl x509 -in /etc/kubernetes/ssl/kube-apiserver.pem -noout -dates

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 をインストールします

ホストで以下のコマンドを実行します:

yum install nfs-utils 

フィードバック

このページは役に立ちましたか?