Skip to content

Commit aeb7072

Browse files
committed
translated tests and forking pages
1 parent 99b15da commit aeb7072

File tree

2 files changed

+47
-0
lines changed

2 files changed

+47
-0
lines changed

content/ja/docs/demo/forking.md

+25
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: デモリポジトリをフォークする
3+
linkTitle: フォーク
4+
default_lang_commit: 99b15da7137cde4a6352576768f4c9203170d569
5+
---
6+
7+
[demo repository][]は、OpenTelemetryを使用した実装例を紹介するためのツールとして、フォークして使用できるように設計されています。
8+
9+
フォークやデモの環境構築は、通常いくつかの環境変数の上書きと、場合によってはコンテナイメージの置き換えのみで済みます。
10+
11+
実際のデモは[README](https://github.com/open-telemetry/opentelemetry-demo/blob/main/README.md?plain=1)に追加することができます。
12+
13+
## フォークメンテナーへの提案 {#suggestions-for-fork-maintainers}
14+
15+
- デモによって発信または収集されるテレメトリデータを強化したい場合は、変更内容をこのリポジトリにバックポートすることを強く推奨します。
16+
ベンダーや実装固有の変更については、コードの根本的な変更よりも、設定によってパイプライン内でテレメトリを変更する戦略が望ましいです。
17+
- 置き換えるのではなく、拡張してください。
18+
既存のAPIと連携する全く新しいサービスを追加することは、テレメトリの変更では実現できないベンダー固有またはツール固有の機能を追加する優れた方法です。
19+
- 拡張性をサポートするため、キュー、データベース、キャッシュなどのリソースにはリポジトリパターンまたはファサードパターンを使用してください。
20+
そうすることで、異なるプラットフォームに対してこれらのサービスの異なる実装を組み込むことができます。
21+
- ベンダーやツール固有の拡張機能をこのリポジトリにバックポートしないでください。
22+
23+
フォークメンテナーとしての作業をより容易にする方法についての質問や提案がありましたら、イシューを作成してください。
24+
25+
[demo repository]: {{% param repo %}}

content/ja/docs/demo/tests.md

+22
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
title: テスト
3+
cSpell:ignore: Tracetest
4+
default_lang_commit: 99b15da7137cde4a6352576768f4c9203170d569
5+
---
6+
7+
現在、このリポジトリにはフロントエンドとバックエンドの両サービスのE2Eテストが含まれています。
8+
フロントエンドでは、[Cypress](https://www.cypress.io/)を使用しており、Webストアの各フローを実行します。
9+
一方、バックエンドサービスでは、統合テストのメインテストフレームワークとして[AVA](https://avajs.dev)を使用しており、トレースベースのテストには[Tracetest](https://tracetest.io/)を使用しています。
10+
11+
すべてのテストを実行する場合は、ルートディレクトリから `make run-tests` を実行します。
12+
13+
特定のテストスイートのみを実行したい場合は、テストの種類ごとに各種テストのコマンドを実行します[^1]:
14+
15+
- **フロントエンドのテスト**: `docker compose run frontendTests`
16+
- **バックエンドのテスト**:
17+
- 統合テスト: `docker compose run integrationTests`
18+
- トレースベーステスト: `docker compose run traceBasedTests`
19+
20+
詳細な情報については、[Service Testing](https://github.com/open-telemetry/opentelemetry-demo/tree/main/test)を参照してください。
21+
22+
[^1]: `docker-compose` は非推奨です。詳細については、[Compose V2 への移行](https://docs.docker.com/compose/migrate/) を参照してください。

0 commit comments

Comments
 (0)