Initial commit

exercises/12-basic-jenkinsfile/instructions.md

@@ -0,0 +1,17 @@
+# Exercise 12
+
+In this exercise, you'll create a declarative pipeline for a Go-based project. The `Jenkinsfile` will use some of the basic features of the pipeline DSL.
+
+## Writing a Basic Jenkinsfile
+
+1. Create a new GitHub repository named `go-on-jenkins`.
+2. Create a new `Jenkinsfile` in the root directory of the repository as well as a simple `main.go` file. The main function just prints "Hello World!". Initialize the project via Go Modules.
+3. Commit the files and push them to the remote repository.
+4. Set up a new pipeline job for this repository in Jenkins.
+5. Install the [Jenkins Go plugin](https://plugins.jenkins.io/golang).
+6. Configure the latest Go runtime as global tool.
+7. Enhance the `Jenkinsfile` based on the following requirements. The Jenkinsfile should use the declarative syntax.
+    * The job can run on all agents.
+    * The job sets the environment variable `GO111MODULES=on`.
+    * The job uses the Go runtime from the global tool definition.
+    * The job specifies one build stage named "Build". The build stage executes the shell command `go build`.

exercises/12-basic-jenkinsfile/solution/solution.md

@@ -0,0 +1,54 @@
+# Solution
+
+Create a new job.
+
+![New Job](./images/new-job.png)
+
+Configure the appropriate SCM.
+
+![Job SCM](./images/job-scm.png)
+
+Install the Go plugin.
+
+![Go Plugin](./images/go-plugin.png)
+
+Configure a Go runtime as global tool.
+
+![Go Global Tool](./images/go-global-tool.png)
+
+The `main.go` file could similar to the one below.
+
+```go
+package main
+
+import "fmt"
+
+func main() {
+    fmt.Println("hello world")
+}
+```
+
+The final `Jenkinsfile` looks similar to the solution below.
+
+```groovy
+pipeline {
+    agent any
+    tools {
+        go 'go-1.12'
+    }
+    environment {
+        GO111MODULE = 'on'
+    }
+    stages {
+        stage('Build') {
+            steps {
+                sh 'go build'
+            }
+        }
+    }
+}
+```
+
+A build of the job installs the Go runtime and executes the build step.
+
+![Declarative Pipeline](./images/declarative-pipeline.png)