Nikhil Pathania
Beginning Jenkins Blue OceanCreate Elegant Pipelines With Ease
Nikhil Pathania
Brande, Denmark
ISBN 978-1-4842-4157-8e-ISBN 978-1-4842-4158-5
https://doi.org/10.1007/978-1-4842-4158-5
Library of Congress Control Number: 2018965935
© Nikhil Pathania 2019
Standard Apress
Trademarked names, logos, and images may appear in this book. Rather than use a trademark symbol with every occurrence of a trademarked name, logo, or image we use the names, logos, and images only in an editorial fashion and to the benefit of the trademark owner, with no intention of infringement of the trademark. The use in this publication of trade names, trademarks, service marks, and similar terms, even if they are not identified as such, is not to be taken as an expression of opinion as to whether or not they are subject to proprietary rights.
While the advice and information in this book are believed to be true and accurate at the date of publication, neither the authors nor the editors nor the publisher can accept any legal responsibility for any errors or omissions that may be made. The publisher makes no warranty, express or implied, with respect to the material contained herein.
Distributed to the book trade worldwide by Springer Science+Business Media New York, 233 Spring Street, 6th Floor, New York, NY 10013. Phone 1-800-SPRINGER, fax (201) 348-4505, e-mail [email protected], or visit www.springeronline.com. Apress Media, LLC is a California LLC and the sole member (owner) is Springer Science + Business Media Finance Inc (SSBM Finance Inc). SSBM Finance Inc is a Delaware corporation.

Dedicated to the open-source community

Introduction

Jenkins is the de facto tool to implement Continuous Delivery and the first choice among users. It is open source and has an extensive library of plugins, which makes it lucrative among its contenders. Moreover, recently with the addition of the “Pipeline as Code” feature to Jenkins combined with the plugins that support “Pipeline as Code,” it has become possible to create complex Continuous Delivery pipelines of any degree.

However, the things that make Jenkins extensible also make it a sophisticated tool to learn; as a result, over the years Jenkins has gained a reputation of being a comprehensive yet difficult Continuous Delivery tool to master.

To ease the learning curve, Jenkins has come up with its Blue Ocean flavor. Jenkins Blue Ocean intends to make the process of creating Continuous Delivery pipelines easy and fun, with its intuitive user interface and its powerful Pipeline editor. As a result, Jenkins Blue Ocean has become an attractive entry point for users who wish to join the Continuous Delivery arena.

The topics discussed in this book will take the readers through all the features embedded in Jenkins Blue Ocean.

Acknowledgments

First and foremost, I would like to thank my beautiful wife Karishma for supporting and helping me write yet another book on Jenkins. I would like to thank Nikhil Karkal for bringing me this opportunity. And I give great thanks to Nitesh Agarwal, who provided me with valuable feedback and suggestions throughout the writing process.

A special thanks to Divya Modi, Matthew Moodie, and the entire Apress publishing team that worked hard to make this book the best possible experience for the readers.

I would also like to thank all the amazing readers for giving us their valuable feedback through Twitter, Amazon, Goodreads, Apress, and Springer websites. I read them seriously, and they help me understand you, the readers, better. So please keep giving me feedback.

And finally, a great thanks to the Jenkins Blue Ocean team and the Jenkins community for creating such fantastic software.

Table of Contents

Chapter 1:​ Introduction 1
What Is Jenkins Blue Ocean?​ 1
A Response to Stimuli 2
A Continuous Delivery Tool for Everyone 3
A Jenkins Plugin 4
What Blue Ocean Offers?​ 5
Pipeline Creation Wizard 5
Visual Pipeline Editor 8
Jenkinsfile 10
Pipeline Visualization 11
View Changes, Tests, and Artifacts 13
Pipeline Activity/​Branches 15
Blue Ocean Dashboard 16
Things to Consider 17
Running Existing Jenkins Projects in Blue Ocean 17
Do Freestyle/​Multi-Configuration Projects Work in Blue Ocean?​ 18
Declarative Pipeline Syntax 19
Sailing Through Complex Pipelines 21
Do I Still Need to Visit the Standard Jenkins Interface?​ 23
Is It Wise to Move Now?​ 24
Who Should Use Blue Ocean?​ 25
What to Expect in the Future?​ 26
Summary 27
Chapter 2:​ Setting up Jenkins Blue Ocean 29
Setting up Blue Ocean Using Docker 30
Download the Jenkins Blue Ocean Docker Image 30
Spawning a Jenkins Blue Ocean Container 33
Running Through the Jenkins Startup Wizard 37
Setting up Blue Ocean on an Existing Jenkins Server 48
Things to Consider 52
While Running Jenkins Blue Ocean Behind Apache 53
While Running Jenkins Blue Ocean Behind Nginx 54
While Running Jenkins Blue Ocean with Apache Tomcat 59
Summary 60
Chapter 3:​ Creating Your First Pipeline 61
Prerequisites 62
Pulling the Docker Image for Jenkins Agent 63
Creating Credentials for the Docker Image in Jenkins 63
Installing the Docker Plugin 65
Configuring the Docker Plugin 66
Using the Pipeline Creation Wizard 72
Integrating Blue Ocean Pipeline with a Git Repository 73
Integrating Blue Ocean Pipeline with a GitHub Repository 77
Integrating Blue Ocean Pipeline with a Bitbucket repository 83
Integrating Blue Ocean Pipeline with a GitLab Repository 86
Viewing the Saved Credentials for your Repository in Jenkins 90
Using the Visual Pipeline Editor 91
Assigning a Global Agent 92
Creating a Build &​ Test Stage 92
Adding Steps 93
Adding a Shell Script Step 95
Adding a Stash Step to Pass Artifact Between Stages 96
Assigning an Agent for the Build &​ Test Stage 99
Creating a Report &​ Publish Stage 100
Adding an Un-Stash Step 102
Report Testing Results 104
Upload Artifacts to Blue Ocean 107
Assigning an Agent for the Report &​ Publish Stage 110
Using the Pipeline Visualization 112
Canceling a Running Pipeline 113
Re-Running a Pipeline 114
Using the Pipeline Flow 115
Tracing Logs at the Step, Stage, and Pipeline Level 115
Using the Tests View 116
Using the Artifacts View 118
Editing an Existing Pipeline in Blue Ocean 119
Run an Artifactory Server 120
Installing the Artifactory Plugin for Jenkins 122
Configuring the Artifactory Plugin in Jenkins 123
Editing the Pipeline in Jenkins Blue Ocean 124
Viewing Pipelines for Multiple Branches of a Project 132
Running a Pipeline for a Pull Request 134
Summary 138
Chapter 4:​ Declarative Pipeline Syntax 141
Introduction to Pipeline as Code 142
Scripted Pipeline 142
Declarative Pipeline 144
Jenkinsfile 146
Declarative Pipeline Syntax 146
Sections 147
Directives 155
Sequential Stages 181
Parallel Stages 185
Steps 188
Summary 190
Chapter 5:​ Declarative Pipeline Development Tools 191
Auto-Completion and Syntax Highlighting in Atom Editor 192
Installing the Package for Auto-Completion and Syntax Highlighting 192
Modifying the File config.​cson 193
Auto-Completion and Syntax Highlighting in Action 193
Syntax Highlighting and Jenkinsfile Validation in Visual Studio Code 194
Installing the Extension for Syntax Highlighting 195
Installing the Extension for Jenkinsfile Validation 196
Modifying the File settings.​json 196
Syntax Highlighting and Jenkinsfile Validation in Action 198
Auto-Completion, Syntax Highlighting, and Jenkinsfile Validation in Eclipse IDE 199
Installing the Plugin to Auto-Completion, Syntax Highlighting, and Jenkinsfile Validation 200
Modifying the Jenkins Editor Plugin Settings 201
Auto-Completion, Syntax Highlighting, and Jenkinsfile Validation in Action 202
Declarative Directive Generator in Jenkins 204
Snippet Generator in Jenkins 206
Summary 209
Chapter 6:​ Working with Shared Libraries 211
Why Use Shared Libraries?​ 212
How Shared Libraries Work?​ 213
The Directory Structure for Shared Libraries 213
Retrieving Shared Libraries 215
Retrieving Shared Libraries Using Pre-Configured Settings in Jenkins 215
Retrieving Shared Libraries Directly During the Pipeline Runtime 219
Calling Shared Libraries Inside Your Pipeline 220
Creating Shared Libraries 222
Using Global Variables with Shared Libraries 222
Using Custom Steps with Shared Libraries 223
Summary 231
Appendix 233
Setting up a Docker Host 233
Prerequisites 233
Set up the Repository 234
Install Docker 235
Enabling Docker Remote API (Critical) 236
Modifying the docker.​conf File 236
Modifying the docker.​service File 238
Enabling Proxy Compatibility for Jenkins 239
Index 241

About the Author and About the Technical Reviewer

About the Author

Nikhil Pathania
../images/472510_1_En_BookFrontmatter_Figb_HTML.jpg

is currently practicing DevOps at Siemens Gamesa Renewable Energy in Denmark. He has been working in the DevOps industry for over 10 years. Nikhil started his career in software configuration management as an SCM engineer and later moved on to learn various other tools and technologies in the field of automation and DevOps.

During his career, Nikhil has architected and implemented continuous integration and continuous delivery solutions across diverse IT projects. He enjoys finding new and better ways to automate and improve manual processes.

In his spare time, Nikhil likes to read, write, and meditate. He is an avid climber and now hikes and cycles.

You can reach Nikhil on Twitter at @otrekpiko.

 

About the Technical Reviewer

Nitesh Agarwal
../images/472510_1_En_BookFrontmatter_Figc_HTML.jpg

is working as an SDE II with CodeNation building standardized CI/CD pipelines using the gitOps principles. He has also worked in setting up terabyte-scale ETL pipelines in the past. Nitesh has interests in the field of image processing, machine learning, and distributed systems. In his free time he likes playing guitar and watching movies & documentaries.

 
..................Content has been hidden....................

You can't read the all page of ebook, please click here login for view all page.
Reset
3.19.29.89