Oracle Content Management（提供終了）

解決する課題

現在の課題は、終了済みサービスへの依存を残さず、旧リポジトリの内容と公開先を検証可能な形で代替基盤へ移すことです。

• 画像・動画・文書と構造化コンテンツを元ID付きで書き出す
• コンテンツタイプ、分類、公開状態、翻訳バリアントの関係を保持する
• REST/GraphQL、サイト、CDN URLを使う全コンシューマーを特定する
• 代替CMSやObject Storageへ移し、件数・チェックサム・表示結果を照合する
• 旧URLのリダイレクトとキャッシュ失効を含む切替・復旧手順を作る

主要概念と用語（旧サービス）

• インスタンス（OCE Instance）: Oracle Content Management の実体。テナンシ／コンパートメントに作成し、管理 UI と API のエンドポイントを持つ
• アセット（Asset）: 画像・動画・文書などのデジタル資産、およびコンテンツアイテム（構造化データ）の総称
• リポジトリ（Asset Repository）: アセットを束ねる入れ物。アクセス権・公開チャネル・分類（タクソノミ）・ワークフローを束ねる単位
• コンテンツタイプ（Content Type）: 構造化コンテンツのスキーマ定義。フィールドを定義し、コンテンツアイテムはこの型に従う
• コンテンツアイテム（Content Item）: コンテンツタイプに沿って作られた1件の構造化データ。ヘッドレス配信の主対象
• 公開チャネル（Publishing Channel）: コンテンツを公開する宛先の論理単位。チャネルトークンで配信先を識別する
• サイト（Site）: 組み込みのサイトビルダーで作る Web サイト。アセットを参照して構成する
• ワークフロー（Workflow）: 下書きから承認・公開までの状態遷移を定義する仕組み
• ヘッドレス配信: UI を持たず、REST API や GraphQL でコンテンツだけを取得して任意のフロントから利用する形態

仕様・制限・クォータ

• サービスは提供終了済みで、新規作成・容量拡張・継続利用を前提に設計してはいけない
• 移行対象はバイナリだけでなく、コンテンツタイプ、分類、公開状態、翻訳、チャネル、バージョン履歴を含む
• 旧 REST/GraphQL のレスポンス契約とアセットURLを記録し、代替APIとの差分を変換層またはフロント側で吸収する
• エクスポート結果は件数、元ID、言語、ファイルサイズ、チェックサムを台帳化し、欠損を機械的に検出する
• 法令・監査で必要な履歴は、サービス終了後にも読める形式でObject Storage等へ保全する

内部の仕組み

横にスクロール

移行では、旧リポジトリの資産と構造化コンテンツを元ID付きでエクスポートし、コンテンツタイプ、分類、翻訳、公開状態を代替CMSのモデルへ対応付けます。バイナリはObject StorageとCDN、構造化データは代替CMSへ分ける構成も選べます。

フロントエンド、モバイルアプリ、バッチ、検索索引など旧APIの利用元を洗い出し、変換後のAPI契約とURLへ切り替えます。件数とチェックサムだけでなく、代表ページの表示、翻訳、権限、キャッシュ、リダイレクトを検証してから旧依存を外します。

設計パターン / ベストプラクティス

• 移行台帳を先に作る: 元ID、型、言語、公開状態、参照元、移行先ID、チェックサムを1行で追跡する
• 契約を固定する: 旧APIの代表レスポンスを保存し、新APIとの差分と変換規則をテストにする
• 資産とメタデータを分けない: バイナリ、代替テキスト、著作権、分類、翻訳を同じ移行単位で扱う
• 二重読み取りで比較する: 切替前に旧出力と新出力を同じ入力で比較し、欠損と順序差を確認する
• 段階切替する: 参照元ごとに切り替え、エラー率や404が増えたら旧経路へ戻せるようにする

運用・監視

• 移行前後の件数、総容量、言語別件数、公開状態別件数、チェックサム不一致をダッシュボード化する
• 旧URLへのアクセスログから未移行の利用元を探し、404・403・5xxとキャッシュミスを監視する
• エクスポート、変換、投入、検証を再実行可能にし、同じ元IDを二重登録しないようアップサートする
• 監査用の原本エクスポートと変換ログは改変防止と保持期間を設定したObject Storageへ保管する

コスト

サービス利用料ではなく、移行作業、代替CMS、Object Storage、CDN、検索、リダイレクト維持を見積もります。旧サービスの延命費ではなく、検証自動化と復旧可能性へ予算を配分します。

セキュリティ

• 原本エクスポートは暗号化した非公開バケットへ置き、移行担当者だけに期限付き権限を与える
• 代替CMSの編集、公開、配信APIを役割分離し、移行用資格情報は作業完了後に失効する
• 旧チャネルトークン、IDCSアプリ、API資格情報の利用元を洗い出し、切替後に段階的に無効化する
• 変換ログと対応表に機密情報を残しすぎず、アクセスと変更を監査ログで追跡する

関連サービス・比較

旧サービスが担っていた機能を、Object Storageだけで置き換えることはできません。バイナリ保管と、型・翻訳・承認・公開APIを担う代替CMSを分けて評価します。

ハンズオン / 移行確認例

提供終了後に実行できる新規作成CLI/APIはありません。旧 oci oce の参照を新規構築手順へ流用せず、事前に取得したエクスポートを検証します。

# エクスポート済み資産のチェックサム台帳を作成
find "$EXPORT_DIR/assets" -type f -print0 \
  | sort -z \
  | xargs -0 sha256sum > asset-checksums.sha256

# 構造化コンテンツをキー順に正規化し、変換前後の差分を確認
jq -S . "$EXPORT_DIR/content-items.json" > content-items.normalized.json
jq -S . "$IMPORT_DIR/content-items.json" > imported-items.normalized.json
diff -u content-items.normalized.json imported-items.normalized.json