This demo uses Terraform to automate the setup of an NGINX Proxy Cache Web Server pseudo-production environment.
A PDF containing accompanying slides for this demo can also be found under the name of Using NGINX as a Web Server and Reverse Proxy Cache 101.
This demo has been developed and tested with Terraform 0.13 through 1.1.5.
Instructions on how to install Terraform can be found in the Terraform website.
You will need to download the NGINX Plus license to a known location. You can specify the location of the license in the corresponding Terraform variables.
To use the provided Terraform scripts, you need to:
- Export your AWS credentials as environment variables (or alternatively, tweak the AWS provider in
terraform/provider.tf). - Set up default values for variables missing a value in
terraform/variables.tf(you can find example values commented out in the file). Alternatively, you can input those variables at runtime (beware of dictionary values if you do the latter).
Once you have configured your Terraform environment, you can either:
- Run
./setup.shto initialize the AWS Terraform provider and start a Terraform deployment on AWS. - Run
terraform initandterraform apply.
And finally, once you are done playing with the demo, you can destroy the AWS infrastructure by either:
- Run
./cleanup.shto destroy your Terraform deployment. - Run
terraform destroy.
You will find a series of NGINX configuration files in the nginx_proxy_cache_web_server_config folder. The folder is divided into individual steps, meant to be copied into their respective directory in order. By default, the folder is uploaded to your NGINX Plus instance.
A deployment script to help you copy the configuration files, deploy.sh, is also provided. To run the script, use the step number as a parameter, e.g. ./deploy.sh 1 for step 1.
To deploy:
./deploy.sh 1
To test:
curl -s http://localhost
Expected response:
<!DOCTYPE html>
<html>
<center>
<style>
div {
border: 15px solid;
}
.btn {
color: #fff;
background-color: #e74c3c;
outline: none;
border: 0;
color: #fff;
padding: 10px 20px;
text-transform: uppercase;
margin-top: 50px;
border-radius: 10px;
cursor: pointer;
position: relative;
width: 25%;
height: 45px;
}
</style>
<div>
<h1> Welcome to the Grand Canyon!!! </h1><br>
<img src="grand-canyon.jpg" alt="Grand Canyon"
style="width:650px;height:400px;" />
</div>
</center>
</html>To deploy:
./deploy.sh 2
To test:
curl -s http://localhost
Expected response:
<!DOCTYPE html>
<html>
<center>
<style>
div {
border: 15px solid;
}
.btn {
color: #fff;
background-color: #e74c3c;
outline: none;
border: 0;
color: #fff;
padding: 10px 20px;
text-transform: uppercase;
margin-top: 50px;
border-radius: 10px;
cursor: pointer;
position: relative;
width: 25%;
height: 45px;
}
</style>
<div>
<h1> Welcome to the Grand Canyon!!! (Server 1/2) </h1><br>
<img src="grand-canyon.jpg" alt="Grand Canyon"
style="width:650px;height:400px;" />
</div>
</center>
</html>To deploy:
./deploy.sh 3
To test:
curl -s http://localhost/api/7/http/caches | jq
Expected response:
{
"my_cache": {
"size": 618496,
"cold": false,
"hit": {
"responses": 26,
"bytes": 6681729
},
"stale": {
"responses": 0,
"bytes": 0
},
"updating": {
"responses": 0,
"bytes": 0
},
"revalidated": {
"responses": 0,
"bytes": 0
},
"miss": {
"responses": 3,
"bytes": 607799,
"responses_written": 3,
"bytes_written": 607799
},
"expired": {
"responses": 0,
"bytes": 0,
"responses_written": 0,
"bytes_written": 0
},
"bypass": {
"responses": 0,
"bytes": 0,
"responses_written": 0,
"bytes_written": 0
}
}
}