Artemmkin · CharlesTBetz · Mar 22, 2020 · Mar 22, 2020 · Mar 22, 2020 · Mar 22, 2020
diff --git a/.DS_Store b/.DS_Store
diff --git a/README.md b/README.md
diff --git a/docs/00-introduction.adoc b/docs/00-introduction.adoc
@@ -0,0 +1,23 @@
+= Introduction
+
+Let's dream for a little bit...
+
+Imagine that you're a young developer who developed a web application.
+You run and test your application locally and everything works great, which makes you very happy.
+You believe that this is going to blow the minds of Internet users and bring you a lot of money.
+
+Then you realize that there is a small problem.
+You ask yourself a question: "How do I make my application available to the Internet users?"
+
+You're thinking that you can't run the application locally all the time, because your old laptop will become slow for other tasks and will probably crash if a lot of users will be using your app at the same time.
+Besides, your ISP changes randomly the public IP for your router, so you don't know on which IP address your application will be accessible to the public at any given moment.
+
+You start realizing that the problem you're facing is not as small as you thought.
+In fact, there is a whole new craft for you to learn in IT world about running software applications and making sure they are always available to the users.
+
+The craft is called *IT operations*.
+And in almost every IT department, there is an operations (Ops) team who manages the platform where the applications are running.
+
+The tutorial you are about to begin will give you, a young developer, a bit of a glance into what operations work look like and how you can do this work more efficiently by using *Infrastructure as Code* approach.
+
+Next: xref:01-prerequisites.adoc[Prerequisites]
diff --git a/docs/00-introduction.md b/docs/00-introduction.md
diff --git a/docs/01-prerequisites.adoc b/docs/01-prerequisites.adoc
@@ -0,0 +1,38 @@
+= Prerequisites
+
+== Google Cloud Platform
+
+In this tutorial, we use the https://cloud.google.com/[Google Cloud Platform] to provision the compute infrastructure.
+You have already signed up.
+
+Start in the Google Cloud Shell.
+https://cloud.google.com/shell/docs/using-cloud-shell[(review)]
+
+== Google Cloud Platform
+
+=== Set a Default Project, Compute Region and Zone
+
+This tutorial assumes a default compute region and zone have been configured.
+
+Set a default compute region appropriate to your location (https://cloud.google.com/compute/docs/regions-zones[GCP regions and zones]):
+
+[source,bash]
+----
+$ gcloud config set compute/region us-central1
+----
+
+Set a default compute zone appropriate to the zone:
+
+[source,bash]
+----
+$ gcloud config set compute/zone us-central1-c
+----
+
+Verify the configuration settings:
+
+[source,bash]
+----
+$ gcloud config list
+----
+
+Next: xref:02-manual-operations.adoc[Manual operations]
diff --git a/docs/01-prerequisites.md b/docs/01-prerequisites.md
diff --git a/docs/02-manual-operations.adoc b/docs/02-manual-operations.adoc
@@ -0,0 +1,195 @@
+= Manual Operations
+
+To better understand the `Infrastructure as Code` (`IaC`) concept, we will first define the problem we are facing and deal with it with manually to get our hands dirty and see how things work overall.
+
+== Intro
+
+Imagine you have developed a new cool application called https://github.com/dm-academy/node-svc-v1[node-svc].
+
+You want to run your application on a dedicated server and make it available to the Internet users.
+
+You heard about the `public cloud` thing, which allows you to provision compute resources and pay only for what you use.
+You believe it's a great way to test your idea of an application and see if people like it.
+
+You've signed up for a free tier of https://cloud.google.com/[Google Cloud Platform] (GCP) and are about to start deploying your application.
+
+== Provision Compute Resources
+
+First thing we will do is to provision a virtual machine (VM) inside GCP for running the application.
+
+Use the following gcloud command in your terminal to launch a VM with Ubuntu 16.04 distro:
+
+[source,bash]
+----
+$ gcloud compute instances create  node-svc\
+    --image-family ubuntu-minimal-2004-lts  \
+    --image-project ubuntu-os-cloud \
+    --boot-disk-size 10GB \
+    --machine-type f1-micro
+----
+
+== Create an SSH key pair
+
+Generate an SSH key pair for future connections to the VM instances (run the command exactly as it is):
+
+[source,bash]
+----
+$ ssh-keygen -t rsa -f ~/.ssh/node-user -C node-user -P ""
+----
+
+Create an SSH public key for your project:
+
+[source,bash]
+----
+$ gcloud compute project-info add-metadata \
+    --metadata ssh-keys="node-user:$(cat ~/.ssh/node-user.pub)"
+----
+
+Check your ssh-agent is running:
+
+[source,bash]
+----
+$ echo $SSH_AGENT_PID
+----
+
+If you get a number, it is running.
+If you get nothing, then run:
+
+[source,bash]
+----
+$ eval `ssh-agent`
+----
+
+Add the SSH private key to the ssh-agent:
+
+ $ ssh-add ~/.ssh/node-user
+
+Verify that the key was added to the ssh-agent:
+
+[source,bash]
+----
+$ ssh-add -l
+----
+
+== Install Application Dependencies
+
+To start the application, you need to first configure the environment for running it.
+
+Connect to the started VM via SSH using the following two commands:
+
+[source,bash]
+----
+$ INSTANCE_IP=$(gcloud --format="value(networkInterfaces[0].accessConfigs[0].natIP)" compute instances describe node-svc)
+$ ssh node-user@${INSTANCE_IP}
+----
+
+Install Node and npm:
+
+[source,bash]
+----
+$
+$ sudo apt-get install -y nodejs npm
+----
+
+Check the installed version of Node:
+
+[source,bash]
+----
+$ node -v
+----
+
+Install `git`:
+
+[source,bash]
+----
+$ sudo apt -y install git
+----
+
+Clone the application repo into the home directory of `node-user` user (reminder, how do you clone to the right location?):
+
+[source,bash]
+----
+$ git clone https://github.com/dm-academy/node-svc-v1
+----
+
+Navigate to the repo (`cd node-svc-v1`) and check out the 02 branch (matching this lesson)
+
+[source,bash]
+----
+$ git checkout 02
+Branch 02 set up to track remote branch 02 from origin.
+Switched to a new branch '02'
+----
+
+Initialize npm (Node Package Manager) and install express:
+
+[source,bash]
+----
+$ npm install
+$ npm install express
+----
+
+== Start the Application
+
+Look at the server.js file (`cat`).
+We will discuss in class.
+
+Start the Node web server:
+
+[source,bash]
+----
+$ nodejs server.js &
+Running on 3000
+----
+
+Test it:
+
+[source,bash]
+----
+$ curl localhost:3000
+Successful request.
+----
+
+== Access the Application
+
+Open a firewall port the application is listening on (note that the following command should be run on the Google Cloud Shell):
+
+[source,bash]
+----
+$ gcloud compute firewall-rules create allow-node-svc-tcp-3000 \
+    --network default \
+    --action allow \
+    --direction ingress \
+    --rules tcp:3000 \
+    --source-ranges 0.0.0.0/0
+----
+
+Get the public IP of the VM:
+
+[source,bash]
+----
+$ gcloud --format="value(networkInterfaces[0].accessConfigs[0].natIP)" compute instances describe node-svc-instance
+----
+
+Now open your browser and try to reach the application at the public IP and port 3000.
+
+For example, I put in my browser the following URL http://104.155.1.152:3000, but note that you'll have your own IP address.
+
+== Conclusion
+
+Congrats!
+You've just deployed your application.
+It is running on a dedicated set of compute resources in the cloud and is accessible by a public IP.
+Now Internet users can enjoy using your application.
+
+Now that you've got the idea of what sort of steps you have to take to deploy your code from your local machine to a virtual server running in the cloud, let's see how we can do it more efficiently.
+
+Destroy the current VM and firewall rule and move to the next step:
+
+[source,bash]
+----
+$ gcloud compute instances delete -q node-svc
+$ gcloud compute firewall-rules delete -q allow-node-svc-tcp-9292
+----
+
+Next: xref:03-scripts.adoc[Scripts]