Docker で CloudPrem をローカルにインストールする

Docs > CloudPrem > CloudPrem をインストールする > Docker で CloudPrem をローカルにインストールする

CloudPrem は Preview 版です

CloudPrem Preview に参加すると、新しいセルフホスト型のログ管理機能を利用できます。

概要

このインストールガイドでは、単体の Docker コンテナ、または Docker Compose を使って Datadog CloudPrem をローカルで実行する方法を説明します。次の手順に沿って、手元のマシンに最小構成の CloudPrem 環境を立ち上げます。本番導入の前に、CloudPrem の機能を試したり、Datadog とのログ取り込みを検証したりする用途に適しています。

前提条件

CloudPrem を始める前に、次の項目を確認してください。

CloudPrem 機能が有効な Datadog アカウント があること
API 認証情報: Datadog API キーを用意していること
Docker: マシンに Docker がインストールされ、起動していること
Docker Compose (任意): 1 行のコマンドでセットアップできる Docker Compose

インストール手順

以下のインストール方法のいずれかを使用します。

スタンドアロン Docker コンテナ: テスト向けの最小構成
Docker Compose: 1 行のコマンドで CloudPrem と Datadog Agent を起動

この方法では、個別の Docker コンテナを使って最小構成の CloudPrem 環境を立ち上げます。

Datadog の認証情報を環境変数として設定します。

export DD_SITE="datadoghq.com" # または利用中の Datadog site
export DD_API_KEY="your_datadog_api_key"

ステップ 1: CloudPrem を起動する

データディレクトリを作成し、CloudPrem コンテナを起動します。

# CloudPrem を起動する
docker run -d \
  --name cloudprem \
  -v $(pwd)/qwdata:/quickwit/qwdata \
  -e DD_SITE=${DD_SITE} \
  -e DD_API_KEY=${DD_API_KEY} \
  -p 127.0.0.1:7280:7280 \
  datadog/cloudprem run

ステップ 2: Datadog Agent を起動する

ローカルコンテナのログを収集して CloudPrem に送信するには、Datadog Agent を起動します。

docker run \
  --name dd-agent \
  -e DD_API_KEY=${DD_API_KEY} \
  -e DD_SITE=${DD_SITE} \
  -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true \
  -e DD_ENV=dev \
  -e DD_LOGS_ENABLED=true \
  -e DD_LOGS_CONFIG_LOGS_DD_URL=http://host.docker.internal:7280 \
  -e DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL=true \
  -e DD_CONTAINER_EXCLUDE="name:dd-agent" \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc/:ro \
  -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
  -v /var/lib/docker/containers:/var/lib/docker/containers:ro \
  registry.datadoghq.com/agent:latest

この方法では、Datadog Agent インテグレーションを含む CloudPrem 環境をまとめて構成できます。

ステップ 1: Docker Compose ファイルを作成する

作業ディレクトリに docker-compose.yml ファイルを作成します。

services:
  cloudprem:
    image: datadog/cloudprem:edge
    command: ["run"]
    ports:
      - "127.0.0.1:7280:7280"
    environment:
      - DD_SITE=${DD_SITE:-datadoghq.com}
      - DD_API_KEY=${DD_API_KEY}
    volumes:
      - ./qwdata:/quickwit/qwdata
    restart: unless-stopped

  datadog-agent:
    image: registry.datadoghq.com/agent:latest
    environment:
      - DD_API_KEY=${DD_API_KEY}
      - DD_SITE=${DD_SITE:-datadoghq.com}
      - DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true
      - DD_LOGS_ENABLED=true
      - DD_LOGS_CONFIG_LOGS_DD_URL=http://cloudprem:7280
      - DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL=true
      - DD_LOGS_CONFIG_EXPECTED_TAGS_DURATION=100000
      - DD_CONTAINER_EXCLUDE="name:datadog-agent"
      - DD_ENV=dev
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /proc/:/host/proc/:ro
      - /sys/fs/cgroup/:/host/sys/fs/cgroup:ro
      - /var/lib/docker/containers:/var/lib/docker/containers:ro
    depends_on:
      cloudprem:
        condition: service_healthy
    restart: unless-stopped

この Docker Compose 構成では、次の処理を行います。

CloudPrem を起動し、正常状態になるまで待機します。
Datadog Agent を起動して、コンテナログを収集します。

ステップ 2: 環境変数を設定する

同じディレクトリに .env ファイルを作成します。

DD_SITE=datadoghq.com
DD_API_KEY=your_datadog_api_key

ステップ 3: docker compose を起動する

docker compose up -d

次のステップ

いずれかの方法で CloudPrem を起動したら、インストールが正常に動作しているか確認します。

CloudPrem の状態を確認する

CloudPrem が稼働していることを確認する:

curl http://localhost:7280/api/v1/version

バージョン情報を含むレスポンスが返るはずです。

ログを送信する

ターミナルで次のコマンドを実行し、API を使って “Hello World” のログエントリをローカルの CloudPrem インスタンスへ直接送信します。

curl -X POST "http://localhost:7280/api/v2/logs" \
  -H "Content-Type: application/json" \
  -H "DD-API-KEY: ${DD_API_KEY}" \
  -d '[
    {
      "message": "Hello world from CloudPrem",
      "level": "info",
      "service": "demo"
    }
  ]'