Update and document deployment process

Author: djfarrelly

DEPLOYMENT.md

@@ -0,0 +1,49 @@
+# How to deploy this service
+
+## Docker Image
+
+Build the new Docker image. Check for previous version numbers [on Docker Hub here](https://hub.docker.com/repository/docker/bufferapp/buffer-code-exercise-api).
+
+```
+docker build -t bufferapp/buffer-code-exercise-api:<YOUR-NEW-VERSION> .
+```
+
+Verify the Docker image runs correctly:
+
+```
+docker run --rm -p 8888:8888 bufferapp/buffer-code-exercise-api:<YOUR-NEW-VERSION>
+```
+```
+curl http://localhost:8888
+{
+  "status": "awesome"
+}
+```
+
+Push the image to Docker hub
+
+```
+docker push buffer-code-exercise-api:<YOUR-NEW-VERSION>
+```
+
+## Kubernetes Deployemnt
+
+Update the `kubernetes.yaml` file with your new image version and apply the changes (create if the service has been previously deleted).
+
+```
+kubectl apply -f kubernetes-deployment.yaml
+```
+
+Monitor your rollout:
+
+```
+kubectl -n internal get pods -l app=buffer-code-exercise-api
+```
+
+## Kubernetes Service
+
+If a change is required to the Kubernetes service, first get the AWS SSL cert ARN from the AWS dashboard, then apply the changes:
+
+```
+kubectl apply -f kubernetes-service.yaml
+```

kubernetes-deployment.yaml

@@ -0,0 +1,28 @@
+# Update your image tag before applying this file
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: buffer-code-exercise-api
+  labels:
+    app: buffer-code-exercise-api
+  namespace: internal
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: buffer-code-exercise-api
+  template:
+    metadata:
+      labels:
+        app: buffer-code-exercise-api
+    spec:
+      containers:
+      - name: api
+        image: bufferapp/buffer-code-exercise-api:2.0
+        ports:
+        - containerPort: 8888
+        resources:
+          limits:
+            cpu: 100m
+            memory: 200Mi
+      restartPolicy: Always

kubernetes-service.yaml

@@ -0,0 +1,20 @@
+# Before creating or applying, add the AWS SSL Cert ARN
+apiVersion: v1
+kind: Service
+metadata:
+  name: buffer-code-exercise-api
+  labels:
+    app: buffer-code-exercise-api
+  namespace: internal
+  annotations:
+    service.beta.kubernetes.io/aws-load-balancer-ssl-cert: <REPLACE W/ VALID CERT ARN>
+    service.beta.kubernetes.io/aws-load-balancer-backend-protocol: http
+spec:
+  ports:
+    - port: 443
+      targetPort: 8888
+      protocol: TCP
+      name: https
+  selector:
+    app: buffer-code-exercise-api
+  type: LoadBalancer