Collector コンポーネントの自動化

OpenTelemetry Collector コンポーネントの自動化プロセスの説明。

OpenTelemetry Collector コンポーネントページ内のテーブルは、OpenTelemetry Ecosystem Explorer レジストリのデータと自動的に同期されます。このプロセスを管理するコードは scripts/collector-sync にあります。

同期プロセスは、スケジュールで実行される GitHub Action（collector-sync.yml）によって管理されます。

毎晩、GitHub Action は以下のステップを実行します。

すべてのコンポーネントページは data/collector/ ディレクトリから関連データを取り込むショートコードを参照しているため、データファイルが更新されると、コンポーネントページのテーブルは自動的に最新の情報を反映します。

関連するファイルとディレクトリ:

data/collector/: コンポーネントページのテーブルに表示するために使用されるコンポーネントデータファイルが格納されるディレクトリ。
scripts/collector-sync: レジストリデータの取得とコンポーネントデータファイルの更新を行うコードが含まれるディレクトリ。
.github/workflows/collector-sync.yml: 同期プロセスのスケジュール実行を行う GitHub Action ワークフロー。
layouts/_shortcodes/collector-component-rows.html: データファイルから完全な HTML テーブルをレンダリングします。
layouts/_shortcodes/component-link.html: コンポーネントのソースコードリポジトリへのリンクをレンダリングし、コンポーネントテーブルで使用されます。
i18n/<language>.yml: コンポーネントテーブルページの翻訳を含みます（collector_component_ 接頭辞が付いており、ショートコードから参照されます）。

翻訳

Collector コンポーネントページの新しい翻訳を作成するには、以下のステップに従ってください。

content/en/docs/collector/components にある既存の英語コンテンツを、新しい言語に対応するディレクトリ（例: スペイン語の場合は content/es/docs/collector/components）にコピーします。
新しい言語で静的コンテンツ（タイトル、説明など）を翻訳します。
対応する i18n/<language>.yml ファイルが存在し、コンポーネントテーブルで使用される collector_components_ 接頭辞のキーのエントリがあることを確認します。英語のエントリをコピーして値を翻訳できます。