メインコンテンツまでスキップ

トラブルシューティング

このページは、terraform plan または terraform apply でエラーが発生した場合や、plan が想定以上の変更を行おうとする場合に使用してください。各項目では、症状、原因、解決方法を示します。

接続と認証のエラー​

メッセージまたは症状原因解決方法
tenant または VPC の読み取り時のエラーtoken の有効期限切れ、tenant_name の誤り、またはアカウントに VPC への権限がありません。FPTCLOUD_TOKEN と FPTCLOUD_TENANT_NAME を確認します。必要に応じて新しい token を作成します。
please enter vpc namedata source fptcloud_vpc に name 引数がありません。VPC を name で参照します。
UnknownError: System error, please try again !FPT Cloud がリクエストを拒否しましたが、provider はエラーの詳細を表示しません。下記の 「System error」エラーを参照してください。
timeout while waiting for state操作が provider の timeout(デフォルト 15 分)より長くかかっています。Portal でリソースを確認します。操作がまだ実行中の場合は、provider ブロックの timeout を増やしてから再実行します。

「System error」エラー​

UnknownError: System error, please try again ! が発生した場合は、次の項目を順に確認します。

  1. token の有効期限が切れていないこと。
  2. Role で VPC 上のその操作が許可されていること。必要に応じて tenant の管理者に確認を依頼します。
  3. 関連するリソースが Portal 上にまだ存在すること。
  4. 渡した ID が正しいリソースの種類のものであること。たとえば、subnet_id は名前ではなく Subnet の ID である必要があります。
  5. Portal で同じ操作を実行し、完全なエラーメッセージを確認すること。

設定のエラー​

メッセージ原因解決方法
images[0]、flavors[0]、storage_policies[0] での Invalid indexdata source のフィルターに一致する結果がありません。data source で情報を参照するのように一覧全体を表示し、フィルターの値を修正します。
name cannot contain whitespaceリソース名に空白が含まれています。空白の代わりにハイフン - を使います。
Missing required argument必須の引数がありません。メッセージに示された引数を追加します。
The root storage size of an instance can only be increasedstorage_size_gb が現在の root disk 容量より小さくなっています。現在の容量以上の値を設定します。
Storage name ... already existsVPC 内に同じ名前の disk がすでに存在します。disk に別の名前を付けます。
Storage type can not be changed作成済みの disk の type を変更しています。type は変更しないでください。disk の種類を変えたい場合は、新しい disk を作成します。

Subnet の場合は、CIDR 範囲が VPC 内の他の Subnet と重複していないこと、および gateway_ip が CIDR 範囲内にあることも確認してください。

Security Group を削除できない​

症状: terraform destroy が長時間待機した後、Security Group の削除時にエラーを報告します。

原因: FPT Cloud では、どのリソースにも割り当てられていない Security Group しか削除できません。

解決方法:

  1. Security Group に apply_to = [] を設定します。
  2. terraform apply を実行します。
  3. terraform destroy を再実行します。

変数を使ってこの作業を簡単にする方法は、完全な Web アプリケーション基盤を構築するを参照してください。

plan が常に変更を報告する​

症状: apply が成功した後も、terraform plan を実行するたびに同じ変更が報告されます。

原因解決方法
リソースが Portal で変更されました。現在の状態に合わせて設定を更新するか、リソースの変更を Terraform からのみ行うようにします。
Security Group が apply_to で割り当てられているのに、Instance で security_group_ids を宣言しています。Instance から security_group_ids を削除し、apply_to のみを使います。
apply_to は空ですが、Portal で Security Group が追加で割り当てられています。IP を apply_to に追加するか、Security Group に lifecycle { ignore_changes = [apply_to] } を追加します。
Instance の作成後に private_ip または public_ip が変更されました。この 2 つの引数は作成時にのみ使われます。元の値に戻し、public IP を変更するには fptcloud_floating_ip_association を使います。

plan がリソースを再作成しようとする​

症状: plan に must be replaced と # forces replacement が表示されます。

原因: インプレースで更新できない引数を変更しました。Instance の場合は vpc_id、subnet_id、image_name、ssh_key、password です。Subnet の場合は、DNS と tag を除くすべての引数です。

解決方法: 再作成を意図していない場合は、引数を元の値に戻します。image_name を image のフィルターから取得している場合、フィルターが新しい image を返した可能性があります。その Instance の image 名を固定してください。

危険

Instance を再作成すると、root disk とそのデータはすべて削除されます。原因を十分に理解するまで、forces replacement を含む plan を apply しないでください。

Terraform の外部でリソースが削除された​

症状: terraform plan がリソースが見つからないというエラーを報告します。例:Storage not found、Failed to retrieve instance。

原因: リソースは Portal で削除されましたが、Terraform の state にはまだ残っています。

解決方法: リソースが存在しないことを Portal で確認した後、state からリソースを削除します。

terraform state rm fptcloud_storage.app_data

このコマンドは state からリソースを削除するだけで、FPT Cloud は呼び出しません。リソースが設定に残っている場合、次回の terraform apply でリソースが再作成されます。

Instance の private IP が空になる​

症状: Instance の作成直後、output または apply_to に空の文字列が含まれます。

原因: 作成されたばかりの Instance は、短時間 private IP を報告しないことがあります。

解決方法: terraform apply を再実行します。data source は plan のたびに再読み込みされるため、Instance の例のように data source fptcloud_instance で IP を読み取ることをお勧めします。

サポートに問い合わせる際の情報収集​

詳細なログを有効にしてから、エラーになったコマンドを再実行します。

export TF_LOG=DEBUG
export TF_LOG_PATH=terraform-debug.log
terraform apply

FPT Cloud に問い合わせる際は、次の情報を添えてください。

  • コマンドを実行した日時。
  • エラーになったリソースのアドレス。例:fptcloud_instance.web[0]。
  • エラーメッセージ全文。
  • terraform version で確認した provider のバージョン。
警告

ログファイルには機密情報が含まれる場合があります。送信する前に、ログから token とパスワードを削除してください。

次のステップ​