CoTerm est pris en charge sur macOS et Linux.
Installer Datadog CoTerm avec Homebrew ou curl :
brew (macOS uniquement)
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.
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:
...
Initialisez votre fichier de configuration en exécutant :
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.
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_confighost- 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
Documentation, liens et articles supplémentaires utiles: