Les emplacements privés correspondent à des conteneurs Docker installables sur n’importe quelle entité au sein de votre réseau privé. Vous pouvez accéder à l’image du worker de l’emplacement privé sur Google Container Registry. L’image peut être exécutée sur Linux ou Windows si le Docker Engine est disponible sur votre host. Elle peut également être exécutée avec le mode de conteneurs de Linux.

Les emplacements privés sont des services Windows vous permettant dʼeffectuer des installations nʼimporte où au sein de votre réseau privé à lʼaide dʼun fichier MSI. Exécutez ce fichier à partir de la machine virtuelle ou physique sur laquelle vous souhaitez installer lʼemplacement privé.

Les exigences liées à cette machine sont indiquées dans le tableau ci-dessous. Les scripts PowerShell doivent être activés sur la machine sur laquelle vous installez le worker de lʼemplacement privé.

Remarque : pour que Windows Private Locations exécute des tests de navigateurs, ces derniers (comme Chrome, Edge ou Firefox) doivent être installés sur lʼordinateur Windows.

Vous devez installer la version 4.7.2 ou ultérieure de .NET sur votre ordinateur avant de pouvoir utiliser le programme dʼinstallation de MSI.

Exécutez cette commande pour démarrer votre worker d’emplacement privé en montant votre fichier de configuration dans le conteneur. Assurez-vous que votre fichier <NOM_FICHIER_CONFIGURATION_WORKER>.json est placé dans /etc/docker et non dans le dossier de base :

docker run -d --restart unless-stopped -v $PWD/<MY_WORKER_CONFIG_FILE_NAME>.json:/etc/datadog/synthetics-check-runner.json datadog/synthetics-private-location-worker:latest

Remarque : si vous avez bloqué des IP réservées, ajoutez les capacités Linux NET_ADMIN au conteneur de votre emplacement privé.

Cette commande lance un conteneur Docker et prépare votre emplacement privé à l’exécution de tests. Datadog vous conseille d’exécuter le conteneur en mode détaché avec la stratégie de redémarrage adéquate.

Certificats racine

Vous pouvez importer des certificats racine personnalisés dans vos emplacements privés afin que vos tests API et Browser effectue la liaison SSL via vos propres fichiers .pem.

Lorsque vous exécutez les conteneurs de vos emplacements privés, montez les fichiers de certificat .pem pertinents sur /etc/datadog/certs, comme vous le feriez pour le fichier de configuration de vos emplacements privés. Ces certificats font figure d’autorité de certification de confiance et sont utilisés lors de l’exécution des tests.

Pour en savoir plus sur les paramètres des emplacements privés réservés aux administrateurs, consultez la section relative à la configuration.

1. Créez un fichier docker-compose.yml avec :

   version: "3"
   services:
       synthetics-private-location-worker:
           image: datadog/synthetics-private-location-worker:latest
           volumes:
               - PATH_TO_PRIVATE_LOCATION_CONFIG_FILE:/etc/datadog/synthetics-check-runner.json
   

   Remarque : si vous avez bloqué des IP réservées, ajoutez les capacités Linux NET_ADMIN au conteneur de votre emplacement privé.

2. Lancez votre conteneur avec :

   docker-compose -f docker-compose.yml up
   

Certificats racine

Vous pouvez importer des certificats racine personnalisés dans vos emplacements privés afin que vos tests API et Browser effectue la liaison SSL via vos propres fichiers .pem.

Lorsque vous exécutez les conteneurs de vos emplacements privés, montez les fichiers de certificat .pem pertinents sur /etc/datadog/certs, comme vous le feriez pour le fichier de configuration de vos emplacements privés. Ces certificats font figure d’autorité de certification de confiance et sont utilisés lors de l’exécution des tests.

Pour en savoir plus sur les paramètres des emplacements privés réservés aux administrateurs, consultez la section relative à la configuration.

La configuration Podman est similaire à celle de Docker. Vous devez toutefois définir NET_RAW pour pouvoir prendre en charge les tests ICMP.

1. Exécutez sysctl -w "net.ipv4.ping_group_range = 0 2147483647" depuis le host sur lequel le conteneur s’exécute.

2. Exécutez la commande suivante pour démarrer votre worker d’emplacement privé en montant votre fichier de configuration sur le conteneur. Assurez-vous que votre fichier <NOM_FICHIER_CONFIGURATION_WORKER>.json peut être monté sur le conteneur :

   podman run --cap-add=NET_RAW --rm -it -v $PWD/<MY_WORKER_CONFIG_FILE_NAME>.json:/etc/datadog/synthetics-check-runner.json gcr.io/datadoghq/synthetics-private-location-worker:latest
   

   Si vous avez configuré le blocage des IP réservées, ajoutez les capacités Linux NET_ADMIN au conteneur de votre emplacement privé.

Cette commande lance un conteneur Podman et prépare votre emplacement privé à l’exécution de tests. Datadog vous conseille d’exécuter le conteneur en mode détaché avec la stratégie de redémarrage adéquate.

Pour déployer de façon sécurisée le worker des emplacements privés, définissez une ressource de secret Kubernetes et montez-la dans le conteneur à l’emplacement /etc/datadog/synthetics-check-runner.json.

1. Créez un secret Kubernetes avec le fichier JSON précédemment créé en exécutant la commande suivante :

   kubectl create secret generic private-location-worker-config --from-file=<MY_WORKER_CONFIG_FILE_NAME>.json
   

2. Utilisez les déploiements pour décrire le statut souhaité associé à vos emplacements privés. Créez le fichier private-location-worker-deployment.yaml suivant :

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: datadog-private-location-worker
     namespace: default
   spec:
     selector:
       matchLabels:
         app: private-location
     template:
       metadata:
         name: datadog-private-location-worker
         labels:
           app: private-location
       spec:
         containers:
         - name: datadog-private-location-worker
           image: datadog/synthetics-private-location-worker
           volumeMounts:
           - mountPath: /etc/datadog/synthetics-check-runner.json
             name: worker-config
             subPath: <MY_WORKER_CONFIG_FILE_NAME>
         volumes:
         - name: worker-config
           secret:
             secretName: private-location-worker-config
   

   Remarque : si vous avez bloqué des IP réservées, ajoutez les capacités Linux NET_ADMIN au conteneur de votre emplacement privé.

3. Appliquez la configuration :

   kubectl apply -f private-location-worker-deployment.yaml
   

Pour OpenShift, exécutez l’emplacement privé avec la SCC anyuid. Cette opération est requise pour garantir l’exécution de votre test Browser.

Vous pouvez définir dans vos paramètres de configuration des variables d’environnement qui pointent vers des secrets existants que vous avez configurés. Pour créer des variables d’environnement avec des secrets, consultez la documentation Kubernetes (en anglais).

Méthode alternative :

1. Ajoutez l’emplacement privé Datadog Synthetic à vos référentiels Helm :

   helm repo add datadog https://helm.datadoghq.com
   helm repo update
   

2. Installez le chart avec le nom de version <NOM_VERSION> à l’aide du fichier JSON précédemment créé :

   helm install <RELEASE_NAME> datadog/synthetics-private-location --set-file configFile=<MY_WORKER_CONFIG_FILE_NAME>.json
   

Remarque : si vous avez bloqué des IP réservées, ajoutez les capacités Linux NET_ADMIN au conteneur de votre emplacement privé.

Créez une définition de tâche EC2 correspondant à celle indiquée ci-dessous. Remplacez chaque paramètre par la valeur correspondante figurant dans le fichier de configuration de l’emplacement privé que vous avez généré précédemment :

{
    ...
    "containerDefinitions": [
        {
            "command": [
                "--site='...'",
                "--locationID='...'",
                "--accessKey='...'",
                "--datadogApiKey='...'",
                "--secretAccessKey='...'",
                "--privateKey='-----BEGIN RSA PRIVATE KEY-----XXXXXXXX-----END RSA PRIVATE KEY-----'",
                "--publicKey.pem='-----BEGIN PUBLIC KEY-----XXXXXXXX-----END PUBLIC KEY-----'",
                "--publicKey.fingerprint='...'"
            ],
            ...
            "image": "datadog/synthetics-private-location-worker:latest",
            ...
        }
    ],
    ...
    "compatibilities": [
        "EC2"
    ],
    ...
}

Remarques :

• Si vous avez bloqué des IP réservées, configurez un linuxParameters afin d’octroyer les capacités NET_ADMIN aux conteneurs de vos emplacements privés.
• Si vous utilisez les variables d’environnement DATADOG_API_KEY, DATADOG_ACCESS_KEY, DATADOG_SECRET_ACCESS_KEY, DATADOG_PUBLIC_KEY_PEM et DATADOG_PRIVATE_KEY, vous n’avez pas besoin de les inclure à la section "command": [ ].

Créez une définition de tâche Fargate correspondant à celle indiquée ci-dessous. Remplacez chaque paramètre par la valeur correspondante figurant dans le fichier de configuration de l’emplacement privé que vous avez généré précédemment :

{
    ...
    "containerDefinitions": [
        {
            "command": [
                "--site='...'",
                "--locationID='...'",
                "--accessKey='...'",
                "--datadogApiKey='...'",
                "--secretAccessKey='...'",
                "--privateKey='-----BEGIN RSA PRIVATE KEY-----XXXXXXXX-----END RSA PRIVATE KEY-----'",
                "--publicKey.pem='-----BEGIN PUBLIC KEY-----XXXXXXXX-----END PUBLIC KEY-----'",
                "--publicKey.fingerprint='...'"
            ],
            ...
            "image": "datadog/synthetics-private-location-worker:latest",
            ...
        }
    ],
    ...
    "compatibilities": [
        "EC2",
        "FARGATE"
    ],
    ...
}

Remarque : puisque l’option de pare-feu de l’emplacement privé n’est pas prise en charge sur AWS Fargate, le paramètre enableDefaultBlockedIpRanges ne peut pas être défini sur true.

Étant donné que Datadog s’intègre déjà à Kubernetes et AWS, la plateforme est prête pour la surveillance de EKS.

1. Créez un secret Kubernetes avec le fichier JSON précédemment créé en exécutant la commande suivante :

   kubectl create secret generic private-location-worker-config --from-file=<MY_WORKER_CONFIG_FILE_NAME>.json
   

2. Utilisez les déploiements pour décrire le statut souhaité associé à vos emplacements privés. Créez le fichier private-location-worker-deployment.yaml suivant :

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: datadog-private-location-worker
     namespace: default
   spec:
     selector:
       matchLabels:
         app: private-location
     template:
       metadata:
         name: datadog-private-location-worker
         labels:
           app: private-location
       spec:
         containers:
         - name: datadog-private-location-worker
           image: datadog/synthetics-private-location-worker
           volumeMounts:
           - mountPath: /etc/datadog/synthetics-check-runner.json
             name: worker-config
             subPath: <MY_WORKER_CONFIG_FILE_NAME>
         volumes:
         - name: worker-config
           configMap:
             name: private-location-worker-config
   

   Remarque : si vous avez bloqué des IP réservées, configurez un contexte de sécurité afin d’octroyer les capacités Linux NET_ADMIN aux conteneurs de vos emplacements privés.

3. Appliquez la configuration :

   kubectl apply -f private-location-worker-deployment.yaml
   

1. Téléchargez le fichier datadog-synthetics-worker-<version>.amd64.msi et exécutez-le depuis la machine sur laquelle vous souhaitez installer lʼemplacement privé.

2. Cliquez sur Next sur la page dʼaccueil, lisez le texte de lʼEULA et acceptez les conditions dʼutilisation. Cliquez sur Next.

3. Changez lʼemplacement de lʼinstallation de lʼapplication ou conservez les réglages par défaut. Cliquez sur Next.

4. Pour configurer votre emplacement privé Windows, vous pouvez :

   • coller et saisir une configuration JSON pour le worker de votre emplacement privé Synthetics Datadog. Ce fichier est créé par Datadog lorsque vous créez un emplacement privé.
   • parcourir ou saisir un chemin de fichier contenant une configuration JSON pour le worker de votre emplacement privé Synthetics Datadog.
   • Vous pouvez laisser ce champ vide et exécuter C:\\Program Files\Datadog-Synthetics\Synthetics\synthetics-pl-worker.exe --config=<PathToYourConfiguration> dans lʼinvite de ligne de commande de Windows une fois lʼinstallation terminée.

5. Vous pouvez appliquer les options de configuration suivantes :

   Appliquer les règles du pare-feu nécessitées par ce programme au pare-feu Windows

   Autorisez le programme dʼinstallation à appliquer les règles du pare-feu lors de lʼinstallation et à les supprimer lors de la désinstallation.

   Appliquer des règles pour bloquer les IP réservées dans le pare-feu Windows

   Configurez des règles pour bloquer Chrome, Firefox et Edge (si installés) et ajoutez des règles pour bloquer des plages dʼadresses IP réservées sortantes dans le pare-feu Windows.

   Activer la journalisation de fichier

   Autorisez le worker dʼemplacement privé Synthetics à logguer des fichiers dans le répertoire dʼinstallation.

   Jours de rotation des logs

   indique le nombre de jours pendant lesquels les logs sont conservés avant leur suppression du système local.

   Verbosité des logs

   indique la verbosité de la console et du logging de fichiers pour le worker de lʼemplacement privé Synthetics.

6. Cliquez sur Next et Install pour lancer le processus dʼinstallation.

Une fois que le processus est terminé, cliquez sur Finish dans la page signalant la fin de lʼinstallation.

1. Téléchargez le fichier datadog-synthetics-worker-<version>.amd64.msi et exécutez-le depuis la machine sur laquelle vous souhaitez installer lʼemplacement privé.

2. Exécutez lʼune des commandes suivantes dans le répertoire où vous avez téléchargé le programme dʼinstallation :

   • Dans un terminal PowerShell :

     Start-Process msiexec "/i datadog-synthetics-worker-<version>-beta.amd64.msi /quiet /qn WORKERCONFIG_FILEPATH=C:\ProgramData\Datadog-Synthetics\worker-config.json";
     

   • Ou dans un terminal de commande :

     msiexec /i datadog-synthetics-worker-1.43.0-beta.amd64.msi /quiet /qn WORKERCONFIG_FILEPATH=C:\ProgramData\Datadog-Synthetics\worker-config.json
     

Dʼautres paramètres peuvent être ajoutés :