Checking out code
You use the Source Code Checkout task to check out a repository for use by just one job. By default, repositories are checked out to the Bamboo working directory.
Using Source Code Checkout task you can also:
- Check out repositories to a custom directory path in the working directory.
- Specify multiple checkouts that occur at different stages of the build. (Simply add another Source Code Checkout task to a job at any point in the plan.)
For information about specifying a repository for use by all the plan's jobs, or by all plans, see Linking to code repositories.
To configure a new Source Code Checkout task:
- Navigate to the job that should perform the task.
- Click the Tasks tab, and select an existing 'Source Code Checkout' task in the tasks list, or add a new one using the Add Task button.
Configure the task:
Task Description
Enter a description of the task, for display in Bamboo.
Disable this task
Check, or clear, to selectively run this task.
Repository
Select the desired repository. If you wish to add different types of repositories, they must have been previously defined on the plan's Source Repositories tab. See Linking to source code repositories for a list of supported SCMs.
Checkout Directory
The location to which the contents of the selected repository will be checked out to when the task executes.
Force Clean Build
Deletes the previously checked out directory and checks it out again prior to the next build. This may significantly increase build times.- Click Add repository, at the bottom of the 'Task' screen, to check out another repository using this task.
- Click Save.
Screenshot: Configuring a Source Code Checkout task
Notes
- A number of source repositories are supported 'out of the box', as described on the Linking to code repositories page.
- If you need to use a type of repository that is not supported, a number of third-party Source Repository plugin modules are available (e.g. ClearCase plugin). You can also write a Source Repository Module plugin to enable Bamboo to connect to your repository.