メインコンテンツまでスキップ
バージョン: 3.9

Docker を使用してローカル環境に ScalarDL をインストールする方法

注記

このページは英語版のページが機械翻訳されたものです。英語版との間に矛盾または不一致がある場合は、英語版を正としてください。

このドキュメントでは、Docker Compose を使用して、バックエンドの Cassandra サーバーとともに ScalarDL を実行するローカル環境を設定する方法を説明します。

警告

ScalarDL を使用するには、ライセンスキー (試用ライセンスまたは商用ライセンス) が必要です。ライセンスキーをお持ちでない場合は、お問い合わせください。

前提条件​

  • Docker 20.10 以降と Docker Compose V2 以降

    お使いのプラットフォームに応じて、Docker Web サイトの指示に従ってください。

scalardl-samples リポジトリをクローンする​

scalar-labs/scalardl-samples リポジトリは、ユーザーがすぐに ScalarDL の作業を開始するためのプロジェクトです。

  1. ターミナルで、scalardl-samples アプリを実行するローカルマシン上の場所を決定します。次に、scalardl-samples リポジトリをクローンします。

    git clone https://github.com/scalar-labs/scalardl-samples.git

  2. scalardl-samples ディレクトリに移動します。

    cd scalardl-samples

ライセンスキーを設定する​

ScalarDL Ledger のライセンスキーを設定する

ScalarDL Ledger のライセンスキーを設定する必要があります。docker-compose.yml ファイルで、<SET_YOUR_LICENSE_KEY> をライセンスキーに置き換えてください。例:

services:
  scalar-ledger:
    environment:
      - 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"}

ライセンスキーを確認するための証明書ファイルを設定する​

注記

試用ライセンスをお持ちの場合は、この手順をスキップして ScalarDL を起動 することができます。

この手順では、ScalarDL Ledger の証明書ファイルを設定する必要があります。

ScalarDL Ledger の証明書ファイルを設定する

商用ライセンスを使用する場合は、docker-compose.yml ファイルを次のように更新する必要があります。

  • 証明書ファイルのパスを変更する前（デフォルト構成）:

    services:
      scalar-ledger:
        volumes:
          - ./fixture/ledger-key.pem:/scalar/ledger-key.pem
          - ./fixture/ledger.properties.tmpl:/scalar/ledger/ledger.properties.tmpl
          - ./fixture/trial-license-cert.pem:/scalar/license-cert.pem
          # If you have a commercial license key, you must use `commercial-license-cert.pem` instead of `trial-license-cert.pem`.
          # - ./fixture/commercial-license-cert.pem:/scalar/license-cert.pem

  • 証明書ファイルのパスを変更した後:

    services:
      scalar-ledger:
        volumes:
          - ./fixture/ledger-key.pem:/scalar/ledger-key.pem
          - ./fixture/ledger.properties.tmpl:/scalar/ledger/ledger.properties.tmpl
          # - ./fixture/trial-license-cert.pem:/scalar/license-cert.pem
          # If you have a commercial license key, you must use `commercial-license-cert.pem` instead of `trial-license-cert.pem`.
          - ./fixture/commercial-license-cert.pem:/scalar/license-cert.pem

ScalarDLを起動する​

次のコマンドは、Docker コンテナ内のバックエンド Cassandra サーバーとともに ScalarDL Ledger を起動します。

注記

このコマンドを初めて実行すると、必要な Docker イメージが GitHub Container Registry からダウンロードされます。

docker compose up -d

ScalarDL をシャットダウンする​

コンテナをシャットダウンするには、次のコマンドを実行します。

docker compose down -v