トラブルシューティング
このページは、terraform plan または terraform apply でエラーが発生した場合や、plan が想定以上の変更を行おうとする場合に使用してください。各項目では、症状、原因、解決方法を示します。
接続と認証のエラー
| メッセージまたは症状 | 原因 | 解決方法 |
|---|---|---|
| tenant または VPC の読み取り時のエラー | token の有効期限切れ、tenant_name の誤り、またはアカウントに VPC への権限がありません。 | FPTCLOUD_TOKEN と FPTCLOUD_TENANT_NAME を確認します。必要に応じて新しい token を作成します。 |
please enter vpc name | data 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 ! が発生した場合は、次の項目を順に確認します。
- token の有効期限が切れていないこと。
- Role で VPC 上のその操作が許可されていること。必要に応じて tenant の管理者に確認を依頼します。
- 関連するリソースが Portal 上にまだ存在すること。
- 渡した ID が正しいリソースの種類のものであること。たとえば、
subnet_idは名前ではなく Subnet の ID である必要があります。 - Portal で同じ操作を実行し、完全なエラーメッセージを確認すること。
設定のエラー
| メッセージ | 原因 | 解決方法 |
|---|---|---|
images[0]、flavors[0]、storage_policies[0] での Invalid index | data source のフィルターに一致する結果がありません。 | data source で情報を参照するのように一覧全体を表示し、フィルターの値を修正します。 |
name cannot contain whitespace | リソース名に空白が含まれています。 | 空白の代わりにハイフン - を使います。 |
Missing required argument | 必須の引数がありません。 | メッセージに示された引数を追加します。 |
The root storage size of an instance can only be increased | storage_size_gb が現在の root disk 容量より小さくなっています。 | 現在の容量以上の値を設定します。 |
Storage name ... already exists | VPC 内に同じ名前の 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 しか削除できません。
解決方法:
- Security Group に
apply_to = []を設定します。 terraform applyを実行します。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 とパスワードを削除してください。