provider/docker: Add destroy_grace_seconds option to stop container before delete

[magnumopus]

This PR adds an option for stopping containers before delete on destroy actions. This is useful for causing containers to execute graceful shutdown processes e.g. deregistration from Consul or alerting solutions, draining db nodes, etc. Takes an integer which defines the timeout of the docker stop command.

[stack72]

Hi @magnumopus

This looks good to me - the test results are as follows:

% make testacc TEST=./builtin/providers/docker TESTARGS='-run=TestAccDockerContainer_'
==> Checking that code complies with gofmt requirements...
go generate $(go list ./... | grep -v /terraform/vendor/)
TF_ACC=1 go test ./builtin/providers/docker -v -run=TestAccDockerContainer_ -timeout 120m
=== RUN   TestAccDockerContainer_basic
--- PASS: TestAccDockerContainer_basic (25.87s)
=== RUN   TestAccDockerContainer_volume
--- PASS: TestAccDockerContainer_volume (23.82s)
=== RUN   TestAccDockerContainer_customized
--- PASS: TestAccDockerContainer_customized (34.24s)
PASS
ok      github.com/hashicorp/terraform/builtin/providers/docker 83.943s

[ghost]

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.

If you have found a problem that seems similar to this, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.