Skip to content

Commit e89d1ad

Browse files
josh-wongjosh-wong
committed
Merge branch 'main' into scalardl/update-docs-3.12-ja-jp
2 parents f165a6a + 31f9223 commit e89d1ad

File tree

4 files changed

+168
-5
lines changed

4 files changed

+168
-5
lines changed

‎i18n/versioned_docs/ja-jp/docusaurus-plugin-content-docs/version-3.9/how-to-run-applications-with-auditor.mdx‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -349,8 +349,6 @@ scalardl register-function --properties <CLIENT_PROPERTIES_FILE> --function-id <
349349

350350
[ScalarDL Java Client SDK](how-to-write-applications.mdx#scalardl-client-sdk-を使用する) の <JavadocLink packageName="scalardl-java-client-sdk" path="com/scalar/dl/client/service" className="ClientService" /> を使用してコントラクトとファンクションを登録することもできます。
351351

352-
汎用コントラクトを使用している場合は、[汎用コントラクトおよびファンクションの使用](use-generic-contracts.mdx#汎用コントラクトおよびファンクションを登録する)を参照してコントラクトとファンクションを登録してください。
353-
354352
## アプリケーションを実行する
355353

356354
クライアントからコントラクトとファンクションの登録が完了したら、ScalarDL アプリケーションを実行できます。

‎src/components/ja-jp/_getting-started-db-specific-steps.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ ScalarDL Enterprise Edition を使用している場合は、次のようにラ
6767
6868
<h3>ScalarDL を起動する</h3>
6969
70-
以下の手順に従って、ScalarDL Ledger の使用を開始できます。
70+
以下の手順に従って、ScalarDL Ledger を開始できます。
7171
7272
1. 次のコマンドを実行して、{props.productName} をローカルで実行します。
7373

‎src/components/ja-jp/_getting-started-startup-ledger.mdx‎

Lines changed: 167 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,167 @@
1+
import Tabs from '@theme/Tabs';
2+
import TabItem from '@theme/TabItem';
3+
import JavadocLink from "/src/theme/JavadocLink.js";
4+
import DbSpecificSteps from '/src/components/ja-jp/_getting-started-db-specific-steps.mdx';
5+
6+
## 前提条件
7+
8+
- 以下のいずれかの Java Development Kit (JDK):
9+
- **[Oracle JDK](https://www.oracle.com/java/):** 8、11、17、または 21 (LTS バージョン)
10+
- **[OpenJDK](https://openjdk.org/) ([Eclipse Temurin](https://adoptium.net/temurin/)、[Amazon Corretto](https://aws.amazon.com/corretto/)、または [Microsoft Build of OpenJDK](https://learn.microsoft.com/ja-jp/java/openjdk/)):** 8、11、17、または 21 (LTS バージョン)
11+
- [Docker](https://www.docker.com/get-started/) 20.10以降と[Docker Compose](https://docs.docker.com/compose/install/) v2.20.0以降
12+
13+
:::warning
14+
15+
ScalarDL は JDK 8 でビルドされているため、コントラクトは JDK 8 互換のバイナリである必要があります。JDK 8 以外のバージョンを使用する場合は、JDK 8 互換のバイナリをビルドするようにビルドツールを設定する必要があります。バイナリ互換性を指定する方法はいくつかあり、javac の `--release 8` オプションを使用するか、JDK 8 ツールチェーンを使用するように Gradle または Maven の設定を行う方法があります。以下は Gradle の設定例です:
16+
17+
```gradle
18+
java {
19+
toolchain {
20+
languageVersion.set(JavaLanguageVersion.of(8))
21+
}
22+
}
23+
```
24+
25+
Gradle と Maven の設定の詳細については、[Toolchains for JVM projects for Gradle](https://docs.gradle.org/current/userguide/toolchains.html) と [Guide to Using Toolchains for Maven](https://maven.apache.org/guides/mini/guide-using-toolchains.html) を参照してください。
26+
27+
:::
28+
29+
## ScalarDL サンプルリポジトリをクローンする
30+
31+
**ターミナル**を開き、次のコマンドを実行して ScalarDL サンプルリポジトリをクローンします:
32+
33+
```console
34+
git clone https://github.com/scalar-labs/scalardl-samples
35+
```
36+
37+
次に、以下のコマンドを実行して、サンプル設定を含むディレクトリに移動します:
38+
39+
```console
40+
cd scalardl-samples
41+
```
42+
43+
## お使いのデータベースで ScalarDL を起動する
44+
45+
データベースを選択し、コマンドに従って ScalarDL Ledger をデプロイしてください。ScalarDL がサポートするデータベースの一覧については、[データベース](./requirements#databases)を参照してください。
46+
47+
<Tabs groupId="databases" queryString>
48+
<TabItem value="mysql" label="MySQL" default>
49+
<DbSpecificSteps productName="MySQL" shortName="mysql" />
50+
</TabItem>
51+
52+
<TabItem value="postgres" label="PostgreSQL">
53+
<DbSpecificSteps productName="PostgreSQL" shortName="postgres" />
54+
</TabItem>
55+
56+
<TabItem value="oracle" label="Oracle Database">
57+
<DbSpecificSteps productName="Oracle Database" shortName="oracle" />
58+
</TabItem>
59+
60+
<TabItem value="sqlserver" label="SQL Server">
61+
<DbSpecificSteps productName="SQL Server" shortName="sqlserver" />
62+
</TabItem>
63+
64+
<TabItem value="dynamodb" label="DynamoDB">
65+
<DbSpecificSteps productName="DynamoDB" shortName="dynamodb" />
66+
</TabItem>
67+
68+
<TabItem value="cosmosdb" label="Cosmos DB for NoSQL">
69+
70+
<h3>ライセンスを設定する (Enterprise Edition のみ)</h3>
71+
72+
ScalarDL Enterprise Edition を使用している場合は、以下の手順でライセンスを設定してください。Community Edition を使用している場合は、次のセクションに進んで ScalarDL を起動してください。
73+
74+
<details>
75+
<summary>ライセンスを設定するにはこちらをご覧ください</summary>
76+
77+
1. 次のように `cosmosdb/docker-compose-ledger.yml` ファイルで Enterprise Edition 用の Docker イメージを有効にします:
78+
79+
- イメージ変更前 (デフォルト設定):
80+
81+
```yaml
82+
services:
83+
scalardl-ledger:
84+
image: ghcr.io/scalar-labs/scalardl-ledger:${SCALARDL_VERSION}
85+
# image: ghcr.io/scalar-labs/scalardl-ledger-byol:${SCALARDL_VERSION}
86+
```
87+
88+
- イメージ変更後:
89+
90+
```yaml
91+
services:
92+
scalardl-ledger:
93+
# image: ghcr.io/scalar-labs/scalardl-ledger:${SCALARDL_VERSION}
94+
image: ghcr.io/scalar-labs/scalardl-ledger-byol:${SCALARDL_VERSION}
95+
```
96+
97+
2. ScalarDL Ledger のライセンスキーを設定します。`cosmosdb/ledger.properties` ファイル内の `<SET_YOUR_LICENSE_KEY>` をライセンスキーに置き換えます。例:
98+
99+
```properties
100+
##### PLEASE REPLACE THIS VALUE WITH YOUR LICENSE KEY (ENTERPRISE EDITION ONLY) #####
101+
scalar.dl.licensing.license_key={"organization_name":"XXXXXXXX","expiration_date_time":"YYYY-MM-DDTHH:mm:SS+TIMEZONE","product_name":"ScalarDL Ledger","product_version":N,"license_type":"trial","signature":"XXXXXXXX"}
102+
##### PLEASE REPLACE THIS VALUE WITH YOUR LICENSE KEY (ENTERPRISE EDITION ONLY) #####
103+
```
104+
105+
3. ライセンスを確認するには、次のように `cosmosdb/docker-compose-ledger.yml` ファイルを更新します。トライアルライセンスを使用している場合は、この手順をスキップしてください。
106+
107+
- 証明書ファイルパス変更前 (デフォルト設定):
108+
109+
```yaml
110+
services:
111+
scalardl-ledger:
112+
volumes:
113+
- ./ledger.properties:/scalar/ledger/ledger.properties.tmpl
114+
- ../fixture/ledger-key.pem:/scalar/ledger-key.pem
115+
- ../fixture/trial-license-cert.pem:/scalar/license-cert.pem
116+
# If you have a commercial license key, you must use `commercial-license-cert.pem` instead of `trial-license-cert.pem`.
117+
# - ../fixture/commercial-license-cert.pem:/scalar/license-cert.pem
118+
```
119+
120+
- 証明書ファイルパス変更後:
121+
122+
```yaml
123+
services:
124+
scalardl-ledger:
125+
volumes:
126+
- ./ledger.properties:/scalar/ledger/ledger.properties.tmpl
127+
- ../fixture/ledger-key.pem:/scalar/ledger-key.pem
128+
# - ../fixture/trial-license-cert.pem:/scalar/license-cert.pem
129+
# If you have a commercial license key, you must use `commercial-license-cert.pem` instead of `trial-license-cert.pem`.
130+
- ../fixture/commercial-license-cert.pem:/scalar/license-cert.pem
131+
```
132+
133+
</details>
134+
135+
<h3>ScalarDL を起動する</h3>
136+
137+
以下の手順で ScalarDL Ledger を起動できます:
138+
139+
1. Cosmos DB for NoSQL を設定します。
140+
141+
Azure Cosmos DB for NoSQL を使用するには、Azure アカウントが必要です。Azure アカウントをお持ちでない場合は、[Azure Cosmos DB アカウントの作成](https://learn.microsoft.com/ja-jp/azure/cosmos-db/nosql/quickstart-portal#create-account)をご覧ください。
142+
143+
Cosmos DB for NoSQL の設定後、Cosmos DB for NoSQL の設定に基づいて `cosmodb/ledger.properties` 内の以下の項目を変更します。
144+
145+
```properties
146+
scalar.db.contact_points=<COSMOS_DB_FOR_NOSQL_URI>
147+
scalar.db.password=<COSMOS_DB_FOR_NOSQL_KEY>
148+
```
149+
150+
2. 次のコマンドを実行して、ScalarDL Ledger 用のデータベーススキーマをロードします:
151+
152+
```console
153+
docker compose -f cosmosdb/docker-compose-ledger.yml up -d scalardl-ledger-schema-loader
154+
```
155+
156+
3. 次のコマンドを実行して、ScalarDL Ledgerを実行します:
157+
158+
```console
159+
docker compose -f cosmosdb/docker-compose-ledger.yml up -d
160+
```
161+
</TabItem>
162+
163+
<TabItem value="cassandra" label="Cassandra">
164+
<DbSpecificSteps productName="Cassandra" shortName="cassandra" />
165+
</TabItem>
166+
167+
</Tabs>

‎versioned_docs/version-3.9/how-to-run-applications-with-auditor.mdx‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -335,8 +335,6 @@ scalardl register-function --properties <CLIENT_PROPERTIES_FILE> --function-id <
335335

336336
You can also register contracts and functions by using <JavadocLink packageName="scalardl-java-client-sdk" path="com/scalar/dl/client/service" className="ClientService" /> in the [ScalarDL Java Client SDK](how-to-write-applications.mdx#use-the-scalardl-client-sdk).
337337

338-
If you are using generic contracts, see [Register the generic contracts and functions](use-generic-contracts.mdx#register-the-generic-contracts-and-functions) to register contracts and functions.
339-
340338
## Run an application
341339

342340
Now that you have registered contracts and functions from a client, you can now run your application that integrates ScalarDL.

0 commit comments

Comments
 (0)