From adc81bbf16a2c2d777a063cea6a1a72006a770c2 Mon Sep 17 00:00:00 2001 From: Michael Jenkins Date: Wed, 6 Oct 2021 13:59:27 -0700 Subject: [PATCH] Copy main content to README --- README.md | 61 +++++++++++++++++++++++++++++++++---------------------- 1 file changed, 37 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index d0003ad..cd1e50c 100644 --- a/README.md +++ b/README.md @@ -1,34 +1,47 @@ -# Learning Jenkins -This is the repository for the LinkedIn Learning course `Learning Jenkins`. The full course is available from [LinkedIn Learning][lil-course-url]. +# Learning Jenkins, 03-01: Using a global build tool -_See the readme file in the main branch for updated instructions and information._ -## Instructions -This repository has branches for each of the videos in the course. You can use the branch pop up menu in github to switch to a specific branch and take a look at the course at that stage, or you can add `/tree/BRANCH_NAME` to the URL to go to the branch you want to access. +# Prerequisites +You will need to configure Maven as a global build tool. -## Branches -The branches are structured to correspond to the videos in the course. The naming convention is `CHAPTER#_MOVIE#`. As an example, the branch named `02_03` corresponds to the second chapter and the third video in that chapter. -Some branches will have a beginning and an end state. These are marked with the letters `b` for "beginning" and `e` for "end". The `b` branch contains the code as it is at the beginning of the movie. The `e` branch contains the code as it is at the end of the movie. The `main` branch holds the final state of the code when in the course. +In the Jenkins web interface, go to: -When switching from one exercise files branch to the next after making changes to the files, you may get a message like this: +`Manage Jenkins` -> `Global Tool Configuration` -> `Maven installations` -> `Add Maven`. - error: Your local changes to the following files would be overwritten by checkout: [files] - Please commit your changes or stash them before you switch branches. - Aborting +Give your Maven installation a name and check the option to `Install automatically`. -To resolve this issue: - - Add changes to git using this command: git add . - Commit changes using this command: git commit -m "some message" +# Setting up the Jenkins Job +Create a freestyle job and configure it as follows: -## Installing -1. To use these exercise files, you must have the following installed: - - [list of requirements for course] -2. Clone this repository into your local machine using the terminal (Mac), CMD (Windows), or a GUI tool like SourceTree. -3. [Course-specific instructions] +1. Under `Source Code Management`, select `Git` and enter the following URL: +``` +https://github.com/LinkedInLearning/learning-jenkins-3003221 +``` +2. **MAKE SURE TO SET THE `Branch Specifier` to `*/03_01`**. +3. Add a build step using `Invoke Top-Level Maven Target`. +4. Select the Maven version you configured in the previous step. +5. For the goal, enter `package`. +# WINDOWS SYSTEMS +Select the `Execute Windows batch command` build step +``` +java -cp target/hello-1.0-SNAPSHOT.jar com.learningjenkins.App +``` +Save the job and start the build. -[0]: # (Replace these placeholder URLs with actual course URLs) +[Follow this link for more details on Windows](WINDOWS.md) -[lil-course-url]: https://www.linkedin.com/learning/ -[lil-thumbnail-url]: http:// +# MacOS, Linux, and Docker +Select the `Execute shell` build step. +``` +java -cp target/hello-1.0-SNAPSHOT.jar com.learningjenkins.App +``` +Save the job and start the build. + +[Follow this link for more details on MacOS, Linux, and Docker](MAC_LINUX_DOCKER.md) + +# Troubleshooting Errors +``` +ERROR: Couldn't find any revision to build. Verify the repository and branch configuration for this job. +``` +This error means you have probably entered the wrong branch under Source Code Management. You need to enter `*/03_01` for the branch.