chore: add terraform configuration for creating a droplet on Digital Ocean.

Part of #1000

[skip ci]

Author: php-coder

.gitignore

@@ -32,6 +32,12 @@ vagrant/provisioning/roles/php-coder.nginx/
 vagrant/provisioning/roles/mystamps-nginx/files/prod/my-stamps.ru.key
 vagrant/provisioning/roles/mystamps-nginx/files/prod/my-stamps.ru.crt
 
+# Terraform related files
+infra/terraform/.terraform/
+infra/terraform/terraform.tfplan
+infra/terraform/terraform.tfvars
+infra/terraform/terraform.tfstate
+
 # used by docker/prod.yml
 docker/application-prod.properties
 docker/mysql_backup_mystamps.sql.gz

infra/terraform/README.md

@@ -0,0 +1,21 @@
+# Provisioning a server with Terraform
+
+* Setup credentials (only first time)
+  ```console
+  $ cd infra/terraform
+  $ cp terraform.tfvars{.example,}
+  $ vim terraform.tfvars
+  ```
+* Initialize and download modules (if needed)
+  ```console
+  $ terraform init
+  ```
+* Import existing configuration (optionally; only first time)
+  ```console
+  $ terraform import digitalocean_droplet.web <id>
+  ```
+* Plan and apply:
+  ```console
+  $ terraform plan -out terraform.tfplan
+  $ terraform apply terraform.tfplan
+  ```

infra/terraform/my-stamps.tf

@@ -0,0 +1,20 @@
+# @todo #1000 CI: validate and check Terraform configuration
+
+variable "token" {}
+
+# Provider docs: https://www.terraform.io/docs/providers/do/index.html
+provider "digitalocean" {
+  token   = var.token
+  version = "~> 1.12"
+}
+
+# Droplet docs: https://www.terraform.io/docs/providers/do/r/droplet.html
+resource "digitalocean_droplet" "web" {
+  # "ubuntu-16-04-x64" resolves into Ubuntu 16.04.6 while our server is based on Ubuntu 16.04.1
+  image              = "18572320"
+  name               = "my-stamps.ru"
+  region             = "fra1"
+  size               = "s-1vcpu-1gb"
+  private_networking = true
+}
+

infra/terraform/terraform.tfvars.example

@@ -0,0 +1,2 @@
+# How to obtain a token: https://www.digitalocean.com/docs/api/create-personal-access-token/
+token = "<insert-token-here>"