Spinnaker setup

This reposiotry helps you setup spinnaker server

Spinnaker Setup on Kubernetes

kubectl create secret generic spinnaker-aws --from-literal="aws_access_key_id=<AWS ACCESS Key>" --from-literal="aws_secret_access_key=<AWS SECRET KEY>"
kubectl apply -f jenkins.yaml
kubectl apply -f spinnaker.yaml

Access the Spinnaker UI with below URL, replace the hostIP with your system IP

http://hostIP:31000

Access the Jenkins UI with below URL

http://hostIP:31050

You can create an application and add below pipeline code, that will run jenkins job and trigger deploymnt on kubernetes cluster with your approval

{
  "keepWaitingPipelines": false,
  "lastModifiedBy": "anonymous",
  "limitConcurrent": true,
  "spelEvaluator": "v4",
  "stages": [
    {
      "failPipeline": true,
      "judgmentInputs": [
        {
          "value": "Approve"
        }
      ],
      "name": "Manual Judgment",
      "notifications": [],
      "refId": "3",
      "requisiteStageRefIds": [],
      "type": "manualJudgment"
    },
    {
      "continuePipeline": false,
      "failPipeline": true,
      "job": "HelloBuild",
      "master": "my-jenkins-master",
      "name": "Jenkins",
      "parameters": {},
      "refId": "4",
      "requisiteStageRefIds": [
        "3"
      ],
      "type": "jenkins"
    },
    {
      "failPipeline": true,
      "judgmentInputs": [
        {
          "value": "latest"
        }
      ],
      "name": "Manual Judgment",
      "notifications": [],
      "refId": "6",
      "requisiteStageRefIds": [],
      "type": "manualJudgment"
    },
    {
      "account": "my-k8s-account",
      "cloudProvider": "kubernetes",
      "manifests": [
        {
          "apiVersion": "apps/v1",
          "kind": "Deployment",
          "metadata": {
            "labels": {
              "app": "nginx"
            },
            "name": "nginx-deployment"
          },
          "spec": {
            "replicas": 1,
            "selector": {
              "matchLabels": {
                "app": "nginx"
              }
            },
            "template": {
              "metadata": {
                "labels": {
                  "app": "nginx"
                }
              },
              "spec": {
                "containers": [
                  {
                    "image": "nginx:1.14.2",
                    "name": "nginx",
                    "ports": [
                      {
                        "containerPort": 80
                      }
                    ]
                  }
                ]
              }
            }
          }
        }
      ],
      "moniker": {
        "app": "hellobuild"
      },
      "name": "Deploy (Manifest)",
      "refId": "9",
      "requisiteStageRefIds": [
        "6"
      ],
      "skipExpressionEvaluation": false,
      "source": "text",
      "trafficManagement": {
        "enabled": false,
        "options": {
          "enableTraffic": false,
          "services": []
        }
      },
      "type": "deployManifest"
    },
    {
      "account": "my-k8s-account",
      "app": "hellobuild",
      "cloudProvider": "kubernetes",
      "location": "spinnaker",
      "manifestName": "deployment nginx-deployment",
      "mode": "static",
      "name": "Patch (Manifest)",
      "options": {
        "mergeStrategy": "strategic",
        "record": true
      },
      "patchBody": [
        {
          "spec": {
            "replicas": 2,
            "selector": {
              "matchLabels": {
                "app": "nginx"
              }
            },
            "template": {
              "metadata": {
                "labels": {
                  "app": "nginx"
                }
              },
              "spec": {
                "containers": [
                  {
                    "image": "nginx",
                    "name": "nginx"
                  }
                ]
              }
            }
          }
        }
      ],
      "refId": "10",
      "requisiteStageRefIds": [
        "9"
      ],
      "source": "text",
      "type": "patchManifest"
    }
  ],
  "triggers": [
    {
      "enabled": false,
      "job": "HelloBuild",
      "master": "my-jenkins-master",
      "type": "jenkins"
    }
  ],
  "updateTs": "1614223619000"
}

Spinnaker Setup on Ubuntu system

Prerequisistes

• 4vCPU's
• 8GB RAM(minimum)
• 20GB HDD
• AWS Access Key and Secret Key
• AWS S3 Bucket

Setup

The final environment include,

1. Halyard (Tool to setup spinnaker)
2. Single-Node Kubernetes cluster
3. Jenkins Server (for CI)

Please run the below script to install spinnaker on your system, it will prompt some required information for Spinnaker Halyard

bash spinnaker.sh

Jenkins Setup

Above script will take care of Jenkins Server installation, so just finish the below steps to complete the spinnaker setup.

• While script is running, It's recommend to setup login credentails of Jenkins server as we're using CI as Jenkins server. Access your jenkins server with http://nodeIP:5656

• After basic setup, please enable API token with help 'https://stackoverflow.com/questions/45466090/how-to-get-the-api-token-for-jenkins, and provide inputs to above script.

• Configure Jenkins Server Global Secutiry to allow requests from spinnaker https://www.spinnaker.io/guides/tutorials/codelabs/hello-deployment/#enable-jenkins-api

Jenkins Build

Create a new jenkins build and configure. so that we can trigger from spinnaker.

if you don't have any, you can use below details to configure your new jenkins job

• Git code
• Add below steps in build step as Execute shell

    docker rm -f web db
    docker rmi -f myapp mysqldb
    cd /var/lib/jenkins/jobs/HelloBuild/workspace/flask/app
    docker build -t myapp . --no-cache
    cd /var/lib/jenkins/jobs/HelloBuild/workspace/flask/db
    docker build -t mysqldb . --no-cache
    docker images | egrep 'myapp|mysqldb'
    docker run -d -p 3306:3306 --name db mysqldb
    docker run -d -p 5000:5000 --name web --link db:db myapp
    echo "Access myapp application with $(hostname -I | awk '{print $1}'):5000"

Hope you're done with server setup, if you've any issues, please create an issue. we will help you

• Now it's time to explore spinnaker UI and do some real stuff

Spinnaker Deployments

Once you're able to access your spinnaker server with localhost:9000, then follow the below steps to create some intersting stuff

Simple Deployment from Spinnaker

• Create a Project

  

• Click the actions button and Create Application

  

• Select application and Create First Pipeline

  

• Create a Simple stage and save changes

  

• Start Deployment from Spinnaker

  

You should see status as SUCCEEDED, if not please click on Execution Details. Verify from node, whether nginx deployment triggered or not.

Ohoooo!!!! You made first deployment from spinnaker

Trigger Jenkins Pipeline

Now it's for create some standard deployment with Jenkins

• Create a Jenkins Stage

  

• Add Automated triggers as Jenkins

  

• Add Jenkins Stage

  

You can add multiple stage to each pipeline and start manual execution.

It's time to explore spinnaker UI, recommended to explore all the componenets from UI and get an idea

Some Useful Links

• Halyard Commands
• Spinnaker Architecture
• Quick Starts
• Configure Everthing
• Core Concepts