ストーリー

アーティファクトの種類と管理戦略

組織で管理すべきアーティファクト

統一されたレジストリ戦略

組織のアーティファクト管理アーキテクチャ:

                    ┌─────────────────┐
                    │  統一レジストリ    │
                    │  (GitHub Packages)│
                    └───────┬─────────┘
                 ┌──────────┼──────────┐
                 ↓          ↓          ↓
          ┌──────────┐ ┌──────────┐ ┌──────────┐
          │ Container │ │ npm/PyPI │ │ Helm     │
          │ Images   │ │ Packages │ │ Charts   │
          └──────────┘ └──────────┘ └──────────┘

バージョニング戦略

Semantic Versioning の組織標準

組織全体でSemantic Versioning（SemVer）を採用します。

MAJOR.MINOR.PATCH

- MAJOR: 後方互換性のない変更
- MINOR: 後方互換性のある機能追加
- PATCH: 後方互換性のあるバグ修正

例: 2.3.1 → 2.4.0（新機能追加）
    2.4.0 → 3.0.0（破壊的変更）

自動バージョニング

コミットメッセージから自動的にバージョンを決定する仕組みを導入します。

# GitHub Actions: 自動バージョニング
- name: Determine Version
  id: version
  uses: org/auto-version@v1
  with:
    strategy: "conventional-commits"

- name: Tag and Push
  run: |
    git tag "v${{ steps.version.outputs.version }}"
    git push origin "v${{ steps.version.outputs.version }}"

アーティファクトのメタデータとトレーサビリティ

必須メタデータ

すべてのアーティファクトに以下のメタデータを付与します。

コンテナイメージのラベリング

# OCI Image Spec準拠のラベル
LABEL org.opencontainers.image.version="${VERSION}"
LABEL org.opencontainers.image.revision="${COMMIT_SHA}"
LABEL org.opencontainers.image.created="${BUILD_TIME}"
LABEL org.opencontainers.image.source="${REPO_URL}"

アーティファクトの署名と検証

サプライチェーンの信頼性確保

ビルドされたアーティファクトが改ざんされていないことを保証するために、署名と検証の仕組みを導入します。

# コンテナイメージの署名
- name: Sign Image
  uses: sigstore/cosign-installer@v3

- name: Sign
  run: |
    cosign sign --yes \
      ${{ env.REGISTRY }}/${{ env.IMAGE }}:${{ env.VERSION }}

ライフサイクル管理

保持ポリシー

アーティファクトの保持ポリシーを組織で統一し、コスト最適化を図ります。

まとめ

チェックリスト

• アーティファクトの種類と管理戦略を理解した
• 自動バージョニングの仕組みを理解した
• アーティファクトの署名と検証の必要性を理解した

次のステップへ

次は「環境管理とプロモーション戦略」です。ビルドされたアーティファクトを、どの環境にどのように昇格させていくかを学びましょう。

推定読了時間: 30分