terraform workspace delete 명령

terraform workspace delete 명령

terraform workspace delete 명령은 지정된 워크스페이스를 삭제하는 명령이에요.

출처: 문서

본문

사용법 (Usage)

사용법: terraform workspace delete [OPTIONS] NAME

이 명령은 지정된 워크스페이스를 삭제해요.

워크스페이스를 삭제하려면 이미 존재해야 하고, 리소스를 추적 중이면 안 되며, 현재 워크스페이스여도 안 돼요. 워크스페이스가 리소스를 추적 중이라면 -force 플래그를 지정하지 않는 한 Terraform은 삭제를 허용하지 않아요.

또한 다른 백엔드는 워크스페이스가 잠겨 있는지 같은 것처럼 -force 플래그 없이 삭제하기에 안전한 것으로 간주되는지에 대해 다른 제한을 구현할 수 있어요.

리소스를 추적 중인 워크스페이스를 (-force로) 삭제하면 리소스가 "방치(dangling)" 상태가 될 수 있어요. 이는 물리적으로 존재하지만 Terraform이 더 이상 관리할 수 없는 리소스예요. 이것이 때로는 선호되기도 해요: Terraform이 리소스 관리를 중단해서 다른 방식으로 관리되기를 원할 수 있기 때문이에요. 하지만 대부분의 경우 이는 의도된 것이 아니므로 Terraform이 이런 상황에 빠지지 않도록 보호해 줘요.

커맨드 라인 플래그는 모두 선택적이에요. 지원되는 플래그는 다음과 같아요:

  • -force - 리소스를 추적 중이어도 워크스페이스를 삭제해요. 삭제 후 Terraform은 더 이상 워크스페이스의 인프라를 추적하거나 관리할 수 없어요. 기본값은 false예요.
  • -lock=false - 작업 중에 상태 락을 보유하지 않아요. 다른 사람들이 같은 워크스페이스에 대해 동시에 명령을 실행할 수 있다면 위험해요.
  • -lock-timeout=DURATION - 상태 락을 재시도할 기간이에요. 기본값은 0s예요.

예제 (Example)

$ terraform workspace delete example
Deleted workspace "example".

더 알아보기 (Learn more)