Configure the tutorial system
Prepare your system so that you can complete the tutorial.
Tutorial team
In addition to a team and a role, you need access to a a Jira project and connection information, such as the project name and URL.
To prepare the tutorial team, complete the following steps:
- Create a team that you can use throughout the tutorial. If you do
not have administrative privileges, ask your administrator to create a
Tutorials
team for you. - On the
Tutorials
team, assign your user ID to theLead Developer
role or a group that has this role. ATutorials
team is ideal for new users who are onboarding by working though the tutorials. You might want to create an user ID that is only assigned to theTutorials
team, and can be used by all new users.
Using the value stream from the Create a value stream tutorial
The Create a value stream tutorial describes how to create a value stream and customize it by adding a Jira project. The value stream defined in that tutorial is an ideal starting point for this tutorial. If you completed that tutorial, you can use the value stream that you created in that tutorial. You can also use the Jira project that you configured in that tutorial.
If you did not complete the Create a value stream tutorial, you can get a head start on this tutorial by downloading a file that contains the value stream defined in that tutorial. To use the value stream template, replace property placeholders with values corresponding to your environment:
Setting up GitHub for the tutorial
To complete the tutorial, you need a GitHub repository for which you have write permission. In addition, you need a GitHub personal access token. The personal access token enables you to access the GitHub API, and to integrate GitHub repositories into HCL™ Accelerate. After a repository is integrated into a value stream, you can access the pull requests associated with the repository.
Setting up a Jira project
To integrate Jira into the tutorial value stream, you need a Jira project and Jira API key. If you already have a Jira project, you can use that for the tutorial. If you do not have a project already setup, you can follow the instructions provided in the Create a value stream tutorial. After the Jira project is integrated into a value stream, you can access project data and mange Jira issues.