Automated deployment of Outline, a modern knowledge base, using Terraform and Ansible.
The script currently automates deployment of Outline server on Google Cloud Platform. This script will :
- Create a virtual machine
- Add the SSH public key specified in the variables to authorized keys in the virtual machine
- Create a VPC network
- Create Postgres database instance that's accessible only in the VPC network
- Create database and user
- Add firewall rules to open ports 22, 80 and 443 (TCP and ICMP Protocols)
- Install Outline server and it's dependencies
- Deploy the application using PM2
- Install Nginx and Certbot
- Create a reverse proxy to the application
- Get Let's Encrypt certificate for the domain mentioned in
ansible/group_vars/all
(Optional)
- Terraform
- Ansible
- Google Cloud Platform Service Account Private Key with required permissions
- Enable Redis Memorystore on Google Cloud Platform (Optional)
- Domain Name (Optional)
You could use install-terraform.sh
and install-ansible.sh
to install Terraform and Ansible on Debian based linux distributions.
Before running the script, make sure you update values in the file vars.tf
. Alternatively, you can use a .tfvars
file.
Note:
The script by default creates cloud resources that are not covered by GCP Free Tier.
Please calculate the cost of the resources that you mention in the variables *vars.tf* file.
I do not claim responsibility for any cost incurred from running this script.
- Clone this repository
- Make sure Terraform Provisioner Ansible is installed
- Create a service account with Compute Admin and Service Networking Admin roles
- Generate a key for the service account and update the path in variables
- Update the values of the variables in the files
gcp/vars.tf
andansible/group_vars/all
- Change directory to
gcp
- Run
terraform init
- Run
terraform apply
- Sit back and relax
- Update the domain's A record to point to the IP of the VM when prompted
To destroy all the resources the script created, run terraform destroy
.
Caution: This will destroy all resources created using this terraform script. Any data stored on the virtual machine or the database will be permanently deleted.
If you prefer deploying the application elsewhere, you could just use the Ansible Playbook.
You would have to create database manually and provide connection details as parameter extra-vars.
- Ansible
- Domain Name (Optional)
- Update the values of the variables in group_vars/all
- Update ansible hosts file
- Run
ansible-playbook main.yml -i hosts --extra-vars='{"db_ip_address":"127.0.0.1","db_name":"outline_db","db_password":"Passw0rd","db_username":"outline_db_user","enable_redis":true}'