Skip to content

Latest commit

 

History

History
77 lines (60 loc) · 3.24 KB

jenkins-setup.md

File metadata and controls

77 lines (60 loc) · 3.24 KB
Raw

Jenkins Setup

Jenkins is used to build, deploy and setup the infrastructure for Sunbird. Almost everything in Sunbird is automated using Jenkins pipelines which integrates with ansible and other tools.

  • SSH to the Jenkins server and enter the following commands -

       git clone https://github.com/project-sunbird/sunbird-devops.git
   cd sunbird-devops && git checkout tags/release-5.1.0 -b release-5.1.0
   cd deploy/jenkins
   sudo bash jenkins-server-setup.sh

  • Open Jenkins UI in a browser by visiting JENKINS_IP:8080

  • Enter the initial password and follow the on-screen instructions. Choose Install suggested plugin and create an admin user

  • Go to http://JENKINS_IP:8080/pluginManager/available -> Search for ‘Configuration as Code Plugin’ and install the plugin without restart.

Don’t run the following until above steps finished

  • Run the below commands on Jenkins server to install external plugins

      sudo bash jenkins-plugins-setup.sh

  • Setup environment specific Jenkins jobs. Update the environment list as per your requirement in ascending order. For example, if you want to have dev, staging and production environments, follow the below instructions

      cp envOrder.txt.sample envOrder.txt
  vi envOrder.txt
  dev=0
  staging=1
  production=2
  sudo bash jenkins-jobs-setup.sh

  • Restart Jenkins

      sudo service jenkins restart

  • Configure Jenkins

    sudo su jenkins
curl -SsL -o ~/jenkins.yaml https://raw.githubusercontent.com/project-sunbird/sunbird-devops/release-5.1.0/deploy/jenkins/jenkins.yaml
  
# Replace all placeholders ${VALUE} with below mentioned values
${DOCKER_REGISTRY_URL} to the container registry URL which you would like to store the container images
${GH_USERNAME} to the github username which has access to the private repository
${GH_PASSWORD} to the github access token which has access to the private repository
${GH_PRIVATE_REPO_URL} to the private github repository URL where the environment variables and servers information is updated
${GH_PRIVATE_REPO_BRANCH} to the name of the private repo branch where the environment variables and servers information is updated
${GH_PUBLIC_REPO_BRANCH} to "release-5.1.0"
${KP_PUBLIC_REPO_BRANCH} to "release-5.2.0"
${DP_PUBLIC_REPO_BRANCH} to "release-5.1.0"

vim ~/jenkins.yaml

  • Run the below commands on Jenkins server to establish connectivity between Jenkins to kubernetes cluster and servers -

      mkdir -p /var/lib/jenkins/secrets
  cd /var/lib/jenkins/secrets
  touch deployer_ssh_key vault-pass k8s.yaml
  chmod 600 deployer_ssh_key vault-pass k8s.yaml
    • Copy the contents of your server’s private key into /var/lib/jenkins/secrets/deployer_ssh_key
    • Copy the kubernetes config file contents into /var/lib/jenkins/secrets/k8s.yaml
    • Update /var/lib/jenkins/secrets/vault-pass file with the ansible vault password which will be used to encrypt the ansible secrets file

  • Run sudo visudo on jenkins server and add the below line -

      jenkins ALL=(ALL) NOPASSWD:ALL
  • Reboot the Jenkins VM (sudo reboot)