# Bitbucket Pipelines クイックリファレンス

*CI/CD パイプライン、キャッシュ、アーティファクト、デプロイ*

> Source: Bitbucket Documentation (support.atlassian.com/bitbucket-cloud) · MIT

## パイプラインの基本

### 仕組み

| Command | Description |
|---------|-------------|
| `bitbucket-pipelines.yml` | リポジトリルートの設定ファイル |
| `Docker コンテナ` | 各ステップが独自のコンテナで実行 |
| `トリガー` | プッシュ、PR、タグ、スケジュール、または手動 |
| `ビルド時間` | クォータはプランによって異なる |

### パイプラインの有効化

```
# リポジトリ設定 → Pipelines → 有効化
# bitbucket-pipelines.yml をリポジトリルートに追加
# 最初のプッシュでパイプラインが起動
```

## bitbucket-pipelines.yml

### 最小構成

```
image: node:20
pipelines:
  default:
    - step:
        script:
          - npm install
          - npm test
```

### ブランチ固有のパイプライン

```
pipelines:
  branches:
    main:
      - step:
          script:
            - npm run build
            - npm run deploy
```

### タグと PR のパイプライン

```
pipelines:
  tags:
    'v*':
      - step:
          script:
            - npm run release
  pull-requests:
    '**':
      - step:
          script:
            - npm test
```

## ステップ

### ステップオプション

| Command | Description |
|---------|-------------|
| `name` | ステップの表示名 |
| `image` | グローバルの Docker イメージを上書き |
| `script` | 実行するシェルコマンドのリスト |
| `size` | 1x（4GB）または 2x（8GB）のメモリ |
| `max-time` | タイムアウト（分）デフォルト 120 |
| `trigger` | manual で手動実行専用ステップ |

### 並列ステップ

```
- parallel:
    - step:
        name: "Lint"
        script:
          - npm run lint
    - step:
        name: "Test"
        script:
          - npm test
```

### 手動ステップ

```
- step:
    name: "Deploy to Production"
    trigger: manual
    script:
      - ./deploy.sh prod
```

## 変数

### 変数の種類

| Command | Description |
|---------|-------------|
| `リポジトリ変数` | 設定 → Pipelines → Variables |
| `デプロイ変数` | デプロイ環境にスコープされる |
| `セキュア変数` | 暗号化され、ログでマスク |
| `パイプライン変数` | YAML にインラインで定義 |

### 変数の使用

```
pipelines:
  default:
    - step:
        script:
          - echo $MY_VAR
          - docker login -u $DOCKER_USER -p $DOCKER_PASS
```

### 組み込み変数

| Command | Description |
|---------|-------------|
| `$BITBUCKET_COMMIT` | 完全なコミット SHA |
| `$BITBUCKET_BRANCH` | ブランチ名 |
| `$BITBUCKET_TAG` | タグ名（タグパイプライン） |
| `$BITBUCKET_BUILD_NUMBER` | インクリメントするビルド番号 |
| `$BITBUCKET_REPO_SLUG` | リポジトリスラッグ |

## キャッシュ

### 定義済みキャッシュ

```
- step:
    caches:
      - node        # ~/.npm
      - pip         # ~/.cache/pip
      - docker      # Docker レイヤーキャッシュ
    script:
      - npm install
      - npm test
```

### カスタムキャッシュ

```
definitions:
  caches:
    gradle: ~/.gradle/caches
    mylibs: vendor/libs
pipelines:
  default:
    - step:
        caches:
          - gradle
        script:
          - ./gradlew build
```

### キャッシュの動作

| Command | Description |
|---------|-------------|
| `有効期限` | 7日後に期限切れ |
| `スコープ` | リポジトリ内のすべてのパイプラインで共有 |
| `クリア` | Pipelines → Caches → Delete |

## アーティファクト

### ステップ間でファイルを渡す

```
- step:
    name: "Build"
    script:
      - npm run build
    artifacts:
      - dist/**
- step:
    name: "Deploy"
    script:
      - ls dist/    # アーティファクトが利用可能
      - ./deploy.sh
```

### アーティファクトオプション

| Command | Description |
|---------|-------------|
| `artifacts` | 渡すファイルのグロブパターン |
| `ダウンロード` | 後続のステップで自動的に利用可能 |
| `最大サイズ` | ステップあたり 1 GB |
| `保持期間` | ビルド後 14 日間利用可能 |

## デプロイ

### デプロイ環境

```
- step:
    name: "Deploy Staging"
    deployment: staging
    script:
      - ./deploy.sh staging
- step:
    name: "Deploy Production"
    deployment: production
    trigger: manual
    script:
      - ./deploy.sh prod
```

### 環境の種類

| Command | Description |
|---------|-------------|
| `test` | テスト環境 |
| `staging` | ステージング環境 |
| `production` | 本番環境、ダッシュボードで追跡 |

## よくあるパターン

### Docker ビルドとプッシュ

```
- step:
    services:
      - docker
    script:
      - docker build -t myapp:$BITBUCKET_COMMIT .
      - docker login -u $DOCKER_USER -p $DOCKER_PASS
      - docker push myapp:$BITBUCKET_COMMIT
```

### サービスコンテナ

```
definitions:
  services:
    postgres:
      image: postgres:16
      variables:
        POSTGRES_DB: testdb
        POSTGRES_PASSWORD: secret
pipelines:
  default:
    - step:
        services:
          - postgres
        script:
          - npm test
```

### パイプを使った条件付きステップ

```
- step:
    name: "Deploy to S3"
    script:
      - pipe: atlassian/aws-s3-deploy:1.1.0
        variables:
          AWS_ACCESS_KEY_ID: $AWS_KEY
          AWS_SECRET_ACCESS_KEY: $AWS_SECRET
          S3_BUCKET: my-bucket
          LOCAL_PATH: dist/
```