Containerizing a REST API and Deploying to Kubernetes
Download as PPTX, PDF9 likes4,470 views
This document discusses containerizing a REST microservice and deploying it to Kubernetes. It begins by explaining why to build a REST API using Swagger and containerization. It then demonstrates containerizing a sample REST API created with Swagger-node. Finally, it covers deploying the containerized REST API to Kubernetes, including using Kubernetes templates for the deployment and service, and deploying manually or through a CI system.
![@aroach@CiscoDevNetdeveloper.cisco.com
Dockerfile
FROM node:5.11.1
# Create app directory
RUN mkdir -p /usr/src/app
# Establish where your CMD will execute
WORKDIR /usr/src/app
# Bundle app source into the container
COPY ./node_modules /usr/src/app/node_modules
COPY ./api /usr/src/app/api
COPY ./config /usr/src/app/config
COPY ./app.js /usr/src/app/
# Expose the port for the app
EXPOSE 10010
# Execute "node app.js"
CMD ["node", "app.js"]](https://image.slidesharecdn.com/rest-api-k8s-170113172923/85/Containerizing-a-REST-API-and-Deploying-to-Kubernetes-16-320.jpg)
Containerizing a REST API and Deploying to Kubernetes
- 1. And, deploying to Kubernetes Containerizing a REST microservice Ashley Roach – Cisco DevNet Principal Engineer & Evangelist @aroach
- 2. @[email protected] About Me • API & Cloud Evangelist • 10+ Yrs Technical Product Mgmt • Life-long, self-taught developer • Denver, CO • github.com/aroach & github.com/ciscodevnet • Podcast: devtools.libsyn.com • slideshare.net/aroach
- 3. DevNet Vision Help developers build solutions and grow their careers. Learn Code Inspire
- 4. @[email protected] • §1: Why and What • §2: REST API + Container • §3: Deploying to Kubernetes
- 5. @[email protected] §1: Why and What
- 6. @[email protected] • Quickly build a REST API using Swagger • How to containerize it • How to deploy it What is this guy talking about?
- 7. @[email protected] • It’s faster • Saves you from writing boilerplate code • Useful for mocking REST APIs • More reliable deployment mechanism Why build a REST API this way
- 8. @[email protected] § 2: REST + Containers
- 9. @[email protected] Inspiration • Created background “mini-hacks” activity at sales conference • Needed a way for them to submit answers • Why not make them do it via an API?!
- 11. @[email protected] Heart of the Matter
- 12. @[email protected] OpenAPI Spec (fka Swagger) • Open specification for describing REST APIs • A top-down approach where you would use the Swagger Editor to create your Swagger definition and then use the integrated Swagger Codegen tools to generate server implementation. • A bottom-up approach where you have an existing REST API for which you want to create a Swagger definition.
- 13. @[email protected] Swagger-node • Runtime environment that includes Swagger Editor • swagger project <command> • Start • Edit • node app.js for proper deployments
- 16. @[email protected] Dockerfile FROM node:5.11.1 # Create app directory RUN mkdir -p /usr/src/app # Establish where your CMD will execute WORKDIR /usr/src/app # Bundle app source into the container COPY ./node_modules /usr/src/app/node_modules COPY ./api /usr/src/app/api COPY ./config /usr/src/app/config COPY ./app.js /usr/src/app/ # Expose the port for the app EXPOSE 10010 # Execute "node app.js" CMD ["node", "app.js"]
- 17. @[email protected] Makefile run: docker run --rm --name $(NAME)-$(INSTANCE) $(LINK) $(PORTS) $(VOLUMES) $(ENV) $(NS)/$(REPO):$(VERSION) $ make run $ docker run --rm --name swagger-default -p 8080:10010 ciscodevnet/rest-api-swagger:latest
- 20. @[email protected] • Container Orchestration • Keeping your containers up, scaling them, routing traffic to them • Kubernetes != Docker though K8S uses Docker (or CoreOS rkt) What is Kubernetes?
- 21. @[email protected] • MiniKube (local workstation) • Installers (on-prem, hybrid, custom) • Kops (part of core kubernetes.io github) • Kubespray (Ansible + Terraform) • Etc, etc… • Cloud • Google Container Engine (GKE ) • Azure Container Service • Etc… Installation options
- 22. @[email protected] • Step-by-step tutorial of how to assemble a kubernetes cluster • https://github.com/kelseyhightower/kubernetes- the-hard-way Sidebar: K8S the hard way
- 23. Source: http://x-team.com/2016/07/introduction-kubernetes-architecture/
- 25. @[email protected] • Kubectl & ~/.kube/config • Minikube CLI • The Real Way™: CI system Deploying Containers
- 26. @[email protected] K8S templates: deployment # k8s/dev/api-deployment.yaml apiVersion: extensions/v1beta1 kind: Deployment metadata: name: rest-api-swagger spec: replicas: 2 template: metadata: labels: app: rest-api-swagger spec: containers: - name: rest-api-swagger image: ciscodevnet/rest-api-swagger:latest ports: - containerPort: 10010
- 27. @[email protected] K8S templates: service # k8s/services/api-service-lb.yaml kind: Service apiVersion: v1 metadata: name: rest-api-swagger spec: type: LoadBalancer # or NodePort, etc. ports: - name: http port: 8080 targetPort: 10010 protocol: TCP selector: app: rest-api-swagger
- 28. @[email protected] Manual kubectl deployment $ kubectl apply -f k8s/dev/api-deployment.yaml $ kubectl apply -f k8s/services/api-service-lb.yaml $ kubectl describe deployment $ kubectl describe service rest-api-swagger $ kubectl delete -f k8s/dev/api-deployment.yaml $ kubectl delete -f k8s/services/api-service-lb.yaml
- 29. @[email protected] Drone CI kubectl deployment deploy: k8s: image: containers.ex.com/devnet/drone-kubectl apiserver: https://your-gke-api-endpoint #kubectl cluster-info token: $$K8S_TOKEN commands: - 'kubectl apply -f k8s/services/*.yaml’ - 'kubectl apply -f k8s/dev/*.yaml --record’ - 'kubectl describe service ${SERVICE_NAME}’ when: branch: master
- 31. @[email protected] • Swagger-node provides fast REST API creation • Prototyping, mocking • Spec-first development was an adjustment • Container-based workflows made deployment super simple Takeaways
- 32. @[email protected] Helpful Links • https://communities.cisco.com/people/asroach/blog/2016/09/19/building-the-devnet-api- scavenger-hunt • https://communities.cisco.com/people/asroach/blog/2016/08/11/creating-a-cisco-spark- membership-via-google-forms • https://github.com/swagger-api/swagger-node • https://github.com/CiscoDevNet/rest-api-swagger • https://scotch.io/tutorials/authenticate-a-node-js-api-with-json-web-tokens • http://blog.mongodb.org/post/32866457221/password-authentication-with-mongoose-part-1 • http://www.itnotes.de/docker/development/tools/2014/08/31/speed-up-your-docker-workflow- with-a-makefile/ • http://sahatyalkabov.com/how-to-implement-password-reset-in-nodejs/ • https://marcqualie.com/2015/07/docker-dotenv