ayan.poddar/eShopOnContainers
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
eShopOnContainers/k8s/README.CICD.k8s.md
Eduard Tomas c421405d72 doc update style
2017-08-01 10:12:14 +02:00

3.2 KiB
Raw Blame History

Kubernetes CI/CD VSTS

For k8s CI/CD pipeline delivery a series of tasks must be created in VSTS to deploy k8s in Azure

Prerequisites

  • A Kubernetes cluster. Follow Azure Container Service's walkthrough to create one.
  • A private Docker registry. Follow Azure Container Registry's guide to create one.
  • Optionally, previous steps can be skipped if you run gen-k8s-env.ps1 script to automatically create the azure environment needed for kubernetes deployment. Azure cli 2.0 must be previously installed installation guide. For example:
./gen-k8s-env -resourceGroupName k8sGroup -location westeurope -registryName k8sregistry -orchestratorName k8s-cluster -dnsName k8s-dns
  • An Azure Blob storage. It is needed for storing the kubernetes config file used by the hosted agent to access to Kubernetes cluster. Example:
  • Upload the kubernetes config file to the blob storage previously created. Execute the following command which will download the config file into the directory c:\Users\<User>\.kube\ and then, upload it to your blob storage:
https://eshopk8s.blob.core.windows.net/k8s-config/config

Create the VSTS tasks

  1. Create a Download File task to download the kubernetes binary kubectl to the hosted agent. For example:
https://storage.googleapis.com/kubernetes-release/release/v0.0.1.7.0-alpha.0/bin/windows/386/kubectl.exe
  1. Create a Download File task to download the kubernetes config file to the hosted agent. For example:
https://eshopk8s.blob.core.windows.net/k8s-config/config
  1. Create a powershell task to execute the k8s deployment script. For example:
  • Deployment script path
$(System.DefaultWorkingDirectory)/All Microservices/docker-compose/deploy.ps1
  • Deployment script path arguments. Use value:
-deployCI $true -execPath '$(System.DefaultWorkingDirectory)/' -kubeconfigPath '$(System.DefaultWorkingDirectory)/'  -deployInfrastructure $true -imageTag dev -configFile '$(System.DefaultWorkingDirectory)/$(Build.DefinitionName)/docker-compose/conf_local.yml'
  • deployCI: Must be set to $true. This avoids create images (always are pulled from registry) and compile bits.
  • deployInfrastructure: Can be set to $false if don't want to deploy infrastructure containers (like Redis, rabbit, SQL,...).
  • imageTag: Image tag to pull from k8s.
  • configFile: Configuration file (refer to README.k8s.md for more info). This file is part of the VSTS build output.
  • execPath: path where the k8s binary is stored
  • kubeconfigPath: path where the k8s config file is stored

You can use additional parameters (i.e. pass registry and user/password to use custom registry instead of DockerHub. Plase, refer to README.k8s.md for more info.