Skip to content

Latest commit

 

History

History
67 lines (45 loc) · 5 KB

Setup.md

File metadata and controls

67 lines (45 loc) · 5 KB

Workshop Setup

CloudBees Core Team Master Set-up

Setup a work environment for the lessons provided in this workshop. Ask the instructor for the URL of the server you will be using during the workshop.

Today's URL for the CloudBees Core environment is https://workshop.cb-sa.io/cjoc/

Create a Jenkins Account

  1. Goto to the Workshop URL provided by the instructor;
  2. Click on the create an account link in the middle above the Username input.

  3. Complete the Create an account! form (all fields are required) and click the Create account button; IMPORTANT: to ensure uniqueness, use {your GitHub username} as Username for Jenkins account

  4. You should see a Success page - click on the top page link;

Create a Team Master

Next, everyone will get their own Jenkins masters referred to as a Team Master.

  1. If not in CloudBees Team UI, click on the Teams link in the left menu;

  2. Click on the Create team button in the center of your screen;

  3. Name this team - enter a name for your team - IMPORTANT: to ensure uniqueness, use {your GitHub username} and then click Next;

  4. Choose an icon for this team to help uniquely identify your team - select an icon and color for your team and then click Next;
  5. Add people to this team - your user will show up as a Team Admin and we won't be adding any additional users right now, but feel free to look around and then click Next;
  6. Select team master creation recipe - click on the drop-down to see the options, but select the top option: Workshop Default recipe;

  7. Finally, click the Create team button.

  8. While your master is being created (it takes anywhere from 2-3 minutes to provision your Team Master), move onto the next section Create a GitHub.com user account

Create a GitHub.com user account

Setup a GitHub.com user account that will be used later in this workshop. If you have an existing GitHub.com account you will be able to use it if you are comfortable using that account to create a GitHub Organization later in the workshop.

  1. Visit https://github.com/join and fill in the required fields to create a user account.
  2. Select "Unlimited public repositories for free" when choosing your plan.
  3. Verify your email account to ensure you account is activated. An activated account will be required in the next few exercises.

Create a GitHub Personal Access Token

The following instructions cover how to create a Github Personal Access Token that you will use within Jenkins to connect Pipelines, Multibranch Pipelines, and Github Organization Projects to your Github repositories.

  1. Click on this link to automatically select the required Personal access token settings
  2. Click on Generate Token
  3. As the success message says: Make sure to copy your new personal access token now. You won’t be able to see it again!

Create a GitHub Organization

Create a Github organization to use for this workshop:

  1. On Github navigate to Organizations: https://github.com/settings/organizations (after logging in)
  2. Click on New Organization

  3. Fill in the Organization Name, Billing Email, and click on Create Organization - IMPORTANT: Suggest using {your GitHub username}-devoptics as Organization Name

  4. On the Invite organization members - just click the Finish button.

NOTE: Even though you have to provide an email for billing, you will not be charged anything as long as you choose the free option.

Fork the Workshop Repository

The workshop utilizes the helloapp-nodejs repository from the CloudBees DWJW GitHub Organization. Fork the helloapp-nodejs and helloapp-api repositories into the GitHub Organization that you created above (if you are not sure how to fork a repository - see this GitHub Guide on forking):

Back to the Jenkins Setup

You should see the following Create a new Pipeline screen for your Team:

You may proceed to the labs - once you have successfully completed the setup.