diff --git a/bitbucket/1-configure.md b/bitbucket/1-configure.md index 5f5532f..057a96b 100644 --- a/bitbucket/1-configure.md +++ b/bitbucket/1-configure.md @@ -1 +1,62 @@ # Configure credentials for GitHub Actions Importer + +In this lab, you will use the `configure` CLI command to set the required credentials and information for GitHub Actions Importer to use when working with Bitbucket and GitHub. + +You will need to complete all of the setup instructions [here](./readme.md#configure-your-codespace) prior to performing this lab. + +## Configuring credentials + +1. Create a GitHub personal access token (PAT): + - Open github.com in a new browser tab. + - In the top right of the UI, click your profile photo and then click `Settings`. + - In the left panel, click `Developer Settings`. + - Click `Personal access tokens` and then `Tokens (classic)` (if present). + - Click `Generate new token` and then `Generate new token (classic)`. You may be required to authenticate with GitHub during this step. + - Select the following scope: `workflow`. + - Click `Generate token`. + - Copy the generated PAT and save in a safe location. + +2. Create a Bitbucket workspace access token with read scopes for pipeline, project, and repository, using Bitbucket's [documentation](https://support.atlassian.com/bitbucket-cloud/docs/create-a-workspace-access-token/) and store the token in a safe location. + +3. Run the `configure` CLI command: + - Select the `TERMINAL` tab from within the codespace terminal window. + - Run the following command: `gh actions-importer configure`. + - Using the down arrow key to highlight `Bitbucket`, press the spacebar to select, and then press enter to continue. + - At the GitHub PAT prompt, enter the GitHub PAT generated in step 1 and press enter. + - At the GitHub URL prompt, enter the GitHub instance URL or press enter to accept the default value (`https://github.com`). + - At the Bitbucket token prompt, enter the Bitbucket access token from step 2 and press enter. + + ```console + $ gh actions-importer configure + ✔ Which CI providers are you configuring?: Bitbucket + Enter the following values (leave empty to omit): + ✔ Personal access token for GitHub: *************** + ✔ Base url of the GitHub instance: https://github.com + ✔ Personal access token for Bitbucket: *************** + Environment variables successfully updated. + ``` + +## Verify your environment + +To verify your environment is configured correctly, you are going to run the `update` CLI command. The `update` CLI command will download the latest version of GitHub Actions Importer to your codespace. + +1. In the codespace terminal run the following command: + + ```bash + gh actions-importer update + ``` + +2. You should see a confirmation that you were logged into the GitHub Container Registry and the image was updated to the latest version. + + ```console + $ gh actions-importer update + Login Succeeded + latest: Pulling from actions-importer/cli + Digest: sha256:a7d00dee8a37e25da59daeed44b1543f476b00fa2c41c47f48deeaf34a215bbb + Status: Image is up to date for ghcr.io/actions-importer/cli:latest + ghcr.io/actions-importer/cli:latest + ``` + +### Next lab + +[Perform an audit of Bitbucket](./2-audit.md)