Installer Datadog CoTerm

CoTerm est pris en charge sur macOS et Linux.

  1. Installer Datadog CoTerm avec Homebrew ou curl :

    brew (macOS uniquement)

    brew install coterm
    

    curl

    curl --tlsv1.2 --proto '=https' -sSf 'https://coterm.datadoghq.com/install-ddcoterm.sh' | bash
    

    Cette commande télécharge la dernière version de CoTerm dans .ddcoterm/bin/ddcoterm et met à jour votre PATH dans .bashrc et .zshrc. Redémarrez votre terminal ou sourcez votre profil. Si vous utilisez un shell autre que Bash ou Zsh, ajoutez path/to/.ddcoterm/bin à votre PATH manuellement.

  2. Si votre site Datadog n’est pas https://app.datadoghq.com, définissez votre site dans .ddcoterm/config.yaml sous connection_config.host :

    ...
    connection_config:
      host: 
    ...
    
  3. Initialisez votre fichier de configuration en exécutant :

    ddcoterm init
    

    Sélectionnez vos paramètres. Vous pouvez modifier ces paramètres dans le fichier ~/.ddcoterm/config.yaml](#configurer-vos-paramètres-coterm).

Autoriser CoTerm à se connecter à Datadog

Lors de l’initialisation, vous pouvez choisir l’une des méthodes suivantes pour autoriser CoTerm à accéder à votre compte Datadog :

  • OAuth : ouvre un navigateur pour que vous puissiez vous connecter avec OAuth.
  • Clé d’API + clé d’application : vous invite à définir votre clé d’API Datadog et votre clé d’application dans ~/.ddcoterm/config.yaml.
  • Clé d’API uniquement : vous invite à définir votre clé d’API Datadog dans ~/.ddcoterm/config.yaml.
Si vous sélectionnez l'option Clé d'API uniquement, vous ne pouvez pas exiger d'approbations avec la gestion des cas.

Configurer vos paramètres CoTerm

Le fichier ~/.ddcoterm/config.yaml contient vos configurations CoTerm :

process_config
Configurer CoTerm pour qu’il agisse comme un linter et prenne certaines actions lorsqu’il intercepte une commande qui correspond à une règle. Consultez la section Règles de configuration CoTerm.
enable_telemetry
Activer ou désactiver l’envoi de données de télémétrie à Datadog. La valeur par défaut est false.
enable_ptrace
Activer ou désactiver la surveillance expérimentale des processus basée sur ptrace sous Linux. La valeur par défaut est false.
connection_config
host
Hôte pour la connexion à Datadog. La valeur par défaut est https://app.datadoghq.com.
port
Port pour la connexion à Datadog. La valeur par défaut est 443.
api_key
Si vous n’utilisez pas OAuth, votre clé d’API Datadog. Si vous avez activé OAuth, CoTerm utilise OAuth par défaut et ignore api_key.
app_key
Si vous n’utilisez pas OAuth, votre clé d’application Datadog.
Remarque : pour exiger des approbations avec la gestion des cas, vous devez utiliser OAuth ou spécifier à la fois votre clé d’API et votre clé d’application dans ce fichier.

Étapes suivantes

  • Exécutez ddcoterm pour démarrer une session de terminal enregistrée.
  • En savoir plus sur l’utilisation de CoTerm.

Désinstallation

Pour désinstaller CoTerm, supprimez le dossier .ddcoterm.

Pour aller plus loin