アーティファクト管理

目次

• 概要
• 使用場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

ビルドされたバイナリ、Docker イメージ、パッケージを保存、バージョン管理し、環境全体に配布するための包括的なアーティファクト管理戦略を実装します。

使用場面

• Docker イメージレジストリ管理
• パッケージの公開とバージョン管理
• ビルドアーティファクトの保存と取得
• コンテナイメージの最適化
• アーティファクト保持ポリシー
• マルチレジストリ配布
• 依存関係のキャッシング

クイックスタート

最小限の動作例：

# Dockerfile with multi-stage build for optimization
FROM node:18-alpine AS dependencies
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production

FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:18-alpine AS runtime
WORKDIR /app
COPY --from=dependencies /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
COPY package*.json ./

EXPOSE 3000
HEALTHCHECK --interval=30s --timeout=3s --start-period=40s --retries=3 \
  CMD node healthcheck.js

CMD ["node", "dist/server.js"]

// ... (see reference guides for full implementation)

リファレンスガイド

references/ ディレクトリ内の詳細な実装：

ベストプラクティス

✅ すべき こと

• アーティファクトにセマンティックバージョニングを使用する
• デプロイ前にイメージスキャンを実装する
• 古いアーティファクトの保持ポリシーを設定する
• Docker イメージにマルチステージビルドを使用する
• アーティファクトに署名し検証する
• アーティファクトの不変性を実装する
• アーティファクトメタデータを文書化する
• 特定のベースイメージバージョンを使用する
• 脆弱性スキャンを実装する
• レイヤーを積極的にキャッシュする
• イメージにコミット SHA でタグを付ける
• ストレージ用にアーティファクトを圧縮する

❌ してはいけない こと

• latest タグを唯一の識別子として使用する
• シークレットをアーティファクトに保存する
• スキャンなしでアーティファクトをプッシュする
• 信頼されていないベースイメージを使用する
• アーティファクト検証をスキップする
• 公開済みアーティファクトを上書きする
• バイナリとソースアーティファクトを混在させる
• イメージレイヤーの最適化を無視する
• 機密情報を含むビルドログを保存する