### Install Bitbucket Pipeline Runner with pipx

Source: https://github.com/mathieu-lemay/pipeline-runner/blob/main/README.md

The recommended method for installing the pipeline-runner tool is using pipx.

```shell
pipx install bitbucket-pipeline-runner
```

--------------------------------

### List Available Bitbucket Pipelines

Source: https://github.com/mathieu-lemay/pipeline-runner/blob/main/README.md

View all available pipelines within your project directory.

```shell
cd <project-directory>
pipeline-runner list
```

--------------------------------

### Generate OIDC Configuration

Source: https://github.com/mathieu-lemay/pipeline-runner/wiki/OIDC

Run the command to generate the OIDC configuration, including keys.

```sh
pipeline-runner oidc-config
```

--------------------------------

### Run a Bitbucket Pipeline

Source: https://github.com/mathieu-lemay/pipeline-runner/blob/main/README.md

Execute a specific pipeline from your project directory.

```shell
cd <project-directory>
pipeline-runner run <pipeline-name>
```

--------------------------------

### Run OIDC Server with Docker

Source: https://github.com/mathieu-lemay/pipeline-runner/wiki/OIDC

Use Docker to run the OIDC server, exposing the public key and issuer. Ensure you use the public key and issuer obtained from the `pipeline-runner oidc-config` command.

```sh
# Use public key and issuer from `pipeline-runner oidc-config`
docker run -e OIDC_SERVER_PUBLIC_KEY=<public-key> -e OIDC_SERVER_ISSUER=<issuer> rogueconsulting/pipeline-runner-oidc-server:1.0.0
```

--------------------------------

### Force Docker to Run All Containers on a Different Platform (Apple Silicon)

Source: https://github.com/mathieu-lemay/pipeline-runner/blob/main/README.md

On Apple Silicon, export DOCKER_DEFAULT_PLATFORM to force all Docker containers to run on a specified platform. This feature is experimental.

```shell
export DOCKER_DEFAULT_PLATFORM=linux/amd64
```

--------------------------------

### Enable SSH Agent Forwarding for Pipelines

Source: https://github.com/mathieu-lemay/pipeline-runner/blob/main/README.md

Use the --ssh flag to expose your ssh-agent to the pipeline container, enabling access to private repositories.

```shell
pipeline-runner run --ssh <pipeline-name>
```

--------------------------------

### Enable OIDC Feature Flag

Source: https://github.com/mathieu-lemay/pipeline-runner/wiki/OIDC

Set the environment variable to enable the OIDC feature in the pipeline-runner.

```sh
export PIPELINE_RUNNER_OIDC_ENABLED=1
```

--------------------------------

### Set Alternate Docker Platform for Pipeline Container

Source: https://github.com/mathieu-lemay/pipeline-runner/blob/main/README.md

Export PIPELINE_RUNNER_DOCKER_PLATFORM to specify a different platform for the pipeline container. Replace linux/amd64 with the target platform.

```shell
# Replace linux/amd64 by the target platform
export PIPELINE_RUNNER_DOCKER_PLATFORM=linux/amd64
```

--------------------------------

### Set OIDC Issuer URL

Source: https://github.com/mathieu-lemay/pipeline-runner/wiki/OIDC

Configure the OIDC issuer URL, which must be a valid URL where the public key can be exposed.

```sh
export PIPELINE_RUNNER_OIDC_ISSUER=https://<some-host-you-control>
```

--------------------------------

### Define a Breakpoint in a Pipeline Script

Source: https://github.com/mathieu-lemay/pipeline-runner/blob/main/README.md

Add '# pipeline-runner[breakpoint]' within a pipeline's script section to pause execution at that point for debugging. The entry must be quoted to prevent YAML interpretation as a comment.

```yaml
    example_with_breakpoint:
      - step:
          name: Step with breakpoint
          script:
            - echo "do something"
            - '# pipeline-runner[breakpoint]'
            - echo "do something else"
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.