Installer CloudPrem localement avec Docker

Docs > CloudPrem > Installer CloudPrem > Installer CloudPrem localement avec Docker

CloudPrem est en Preview

Rejoignez la Preview CloudPrem pour accéder aux nouvelles fonctionnalités de Log Management auto-hébergé.

Présentation

Ce guide d’installation vous explique comment exécuter Datadog CloudPrem localement à l’aide de conteneurs Docker autonomes ou de Docker Compose. Suivez ces étapes pour déployer un environnement CloudPrem minimal sur votre machine, idéal pour explorer les fonctionnalités de CloudPrem et tester l’ingestion de logs avec Datadog avant un déploiement en production.

Prérequis

Avant de commencer avec CloudPrem, vérifiez que vous disposez des éléments suivants :

Un compte Datadog avec la fonctionnalité CloudPrem activée.
Identifiants d’API : ayez votre clé d’API Datadog à portée de main.
Docker : Docker installé et en cours d’exécution sur votre machine.
Docker Compose (facultatif) : Docker Compose pour une configuration en ligne de commande unique.

Étapes d’installation

Choisissez l’une des méthodes d’installation suivantes :

Conteneurs Docker autonomes : configuration minimale pour les tests
Docker Compose : ligne de commande unique pour exécuter CloudPrem et l’Agent Datadog

Cette méthode utilise des conteneurs Docker individuels pour une configuration CloudPrem minimale.

Exportez vos identifiants Datadog en tant que variables d’environnement :

export DD_SITE="datadoghq.com"  # or your specific Datadog site
export DD_API_KEY="your_datadog_api_key"

Étape 1 : démarrer CloudPrem

Créez le répertoire de données et démarrez le conteneur CloudPrem :

# Start 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

Étape 2 : démarrer l’Agent Datadog

Pour collecter les logs de vos conteneurs locaux et les envoyer à CloudPrem, démarrez l’Agent Datadog :

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

Cette méthode fournit une configuration CloudPrem avec l’intégration de l’Agent Datadog.

Étape 1 : créer le fichier Docker Compose

Créez un fichier docker-compose.yml dans votre répertoire de travail :

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

La configuration Docker Compose :

Démarre CloudPrem et attend qu’il soit opérationnel.
Démarre l’Agent Datadog pour collecter les logs des conteneurs.

Étape 2 : définir les variables d’environnement

Créez un fichier .env dans le même répertoire :

DD_SITE=datadoghq.com
DD_API_KEY=your_datadog_api_key

Étape 3 : démarrer Docker Compose

docker compose up -d

Étapes suivantes

Après avoir démarré CloudPrem avec l’une ou l’autre méthode, vérifiez que l’installation fonctionne correctement :

Vérifier le statut de CloudPrem

Vérifiez que CloudPrem est en cours d’exécution :

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

Une réponse contenant des informations sur la version doit s’afficher.

Envoyer un log

Dans votre terminal, envoyez une entrée de log “Hello World” directement à votre instance CloudPrem locale via l’API :

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"
    }
  ]'

Rechercher vos logs locaux depuis le Log Explorer

Après avoir vérifié que CloudPrem est en cours d’exécution, vous pouvez rechercher et analyser vos logs dans le Log Explorer en effectuant une recherche dans l’index cloudprem !