Slack Integration for Tracker
Create and manage Tracker events directly from Slack
Tracker Slack est une intégration Slack qui connecte votre plateforme de communication d'équipe avec le système de suivi d'événements Tracker. Elle permet aux équipes de créer, modifier et gérer les événements de déploiement, les incidents, les dérives de configuration et l'utilisation RPA directement depuis Slack en utilisant des commandes slash et des modales interactives.
- 🚀 Intégration Slack Native - Créez des événements sans quitter Slack
- 📝 Modales Interactives - Formulaires riches pour la création d'événements détaillés
- 🔄 Mises à jour en Temps Réel - Modifiez et mettez à jour les événements avec des boutons interactifs
- 📅 Résumés Quotidiens - Résumés automatisés des événements quotidiens via cron
- 🎯 Support Multi-Événements - Gérez les déploiements, incidents, dérives et utilisation RPA
- 🔗 Workflow Transparent - Intégration directe avec l'API Tracker
- ⚡ Actions Rapides - Mises à jour de statut avec réactions emoji et réponses en fil
- Notifications de Déploiement - Annoncez les déploiements avec des workflows d'approbation
- Signalement d'Incidents - Création rapide d'incidents et suivi de statut
- Alertes de Dérive de Configuration - Signalez et suivez les changements d'infrastructure
- Journalisation d'Utilisation RPA - Documentez les exécutions d'automatisation
- Coordination d'Équipe - Notifications des parties prenantes et mises à jour de statut
- Support Daily Standup - Résumés automatisés des événements planifiés
/deployment- Créez des événements de déploiement avec des workflows d'approbation/incident- Signalez et suivez les incidents avec des niveaux de priorité/drift- Documentez la détection de dérive de configuration/rpa_usage- Enregistrez les exécutions d'automatisation de processus robotiques
- Formulaires Riches : Création d'événements complète avec toutes les métadonnées
- Sélection de Projet : Menu déroulant dynamique depuis le catalogue Tracker
- Support d'Environnement : Environnements PROD, PREP, UAT, DEV
- Gestion des Parties Prenantes : Sélection multi-utilisateurs pour les notifications
- Intégration de Liens : Support pour les tickets et pull requests
- Sélecteurs Date/Heure : Planification précise avec support de fuseau horaire
- Modifier les Événements : Modifiez les événements existants via des boutons interactifs
- Mises à jour de Statut : Changements de statut rapides avec des menus déroulants
- Workflow d'Approbation : Approuvez/rejetez les déploiements avec des réactions
- Réponses en Fil : Mises à jour automatiques de statut dans les fils de messages
- Réactions Emoji : Indicateurs de statut visuels sur les messages
- Résumés Quotidiens : Rapports programmés des événements du jour
- Groupement par Environnement : Événements organisés par environnement et projet
- Liens Directs : Accès rapide aux messages Slack originaux
- Support de Fuseau Horaire : Fuseau horaire configurable pour l'affichage de l'heure
- Planification Cron : Planification flexible avec des expressions cron
- API REST : Communication directe avec le backend Tracker
- Synchronisation d'Événements : Synchronisation en temps réel entre Slack et Tracker
- Mappage de Métadonnées : Mappage complet des champs entre plateformes
- Suivi de Statut : Mises à jour de statut bidirectionnelles
- Préservation des Liens : Maintien des connexions vers les ressources externes
- Instance Tracker : Vous avez besoin d'une instance Tracker en cours d'exécution
- Application Slack : Créez une application Slack avec les permissions requises
- Variables d'Environnement : Configurez les variables d'environnement requises
-
Créez une Application Slack sur api.slack.com
-
Configurez OAuth & Permissions avec ces scopes :
chat:write commands reactions:write users:read -
Ajoutez les Commandes Slash :
/deployment- URL de requête :https://votre-domaine.com/slack/command/incident- URL de requête :https://votre-domaine.com/slack/command/drift- URL de requête :https://votre-domaine.com/slack/command/rpa_usage- URL de requête :https://votre-domaine.com/slack/command
-
Activez l'Interactivité :
- URL de requête :
https://votre-domaine.com/slack/interactive_api_endpoint
- URL de requête :
-
Obtenez vos tokens :
- Bot User OAuth Token (commence par
xoxb-) - Signing Secret
- Bot User OAuth Token (commence par
# Téléchargez l'image
docker pull bananaops/tracker-slack:latest
# Exécutez avec les variables d'environnement
docker run -d \
-p 8080:8080 \
-e SLACK_BOT_TOKEN="xoxb-votre-bot-token" \
-e SLACK_SIGNING_SECRET="votre-signing-secret" \
-e TRACKER_HOST="http://votre-instance-tracker:8080" \
-e TRACKER_DEPLOYMENT_CHANNEL="deployments" \
-e TRACKER_INCIDENT_CHANNEL="incidents" \
-e TRACKER_DRIFT_CHANNEL="drift-alerts" \
-e TRACKER_SLACK_WORKSPACE="votre-workspace" \
-e TRACKER_TIMEZONE="Europe/Paris" \
-e TRACKER_SLACK_CRON_MESSAGE="0 8 * * *" \
bananaops/tracker-slack:latest# Ajoutez le dépôt Helm (si disponible)
helm repo add bananaops https://bananaops.github.io/helm-charts
# Installez avec des valeurs personnalisées
helm install tracker-slack bananaops/tracker-slack \
--set secret.slack.bot_token="xoxb-votre-bot-token" \
--set secret.slack.signing_secret="votre-signing-secret" \
--set env.tracker.host="http://tracker.tracker.svc.cluster.local:8080" \
--set ingress.hosts[0].host="tracker-slack.votredomaine.com"# Clonez le dépôt
git clone https://github.com/BananaOps/tracker-slack.git
cd tracker-slack
# Définissez les variables d'environnement
export SLACK_BOT_TOKEN="xoxb-votre-bot-token"
export SLACK_SIGNING_SECRET="votre-signing-secret"
export TRACKER_HOST="http://localhost:8080"
export TRACKER_DEPLOYMENT_CHANNEL="deployments"
export TRACKER_INCIDENT_CHANNEL="incidents"
export TRACKER_DRIFT_CHANNEL="drift-alerts"
export TRACKER_SLACK_WORKSPACE="votre-workspace"
export TRACKER_TIMEZONE="Europe/Paris"
export TRACKER_SLACK_CRON_MESSAGE="0 8 * * *"
# Exécutez l'application
go run main.go| Variable | Description | Défaut | Requis |
|---|---|---|---|
SLACK_BOT_TOKEN |
Token OAuth Bot User Slack | - | ✅ |
SLACK_SIGNING_SECRET |
Secret de Signature de l'App Slack | - | ✅ |
TRACKER_HOST |
URL de base de l'API Tracker | - | ✅ |
TRACKER_DEPLOYMENT_CHANNEL |
Canal Slack pour les déploiements | deployments |
✅ |
TRACKER_INCIDENT_CHANNEL |
Canal Slack pour les incidents | incidents |
✅ |
TRACKER_DRIFT_CHANNEL |
Canal Slack pour les alertes de dérive | drift-alerts |
✅ |
TRACKER_SLACK_WORKSPACE |
Nom du workspace Slack | - | ✅ |
TRACKER_TIMEZONE |
Fuseau horaire pour l'affichage des dates | UTC |
❌ |
TRACKER_SLACK_CRON_MESSAGE |
Planification cron pour les résumés quotidiens | 0 8 * * * |
❌ |
Créez des canaux dédiés pour différents types d'événements :
# Structure de canaux recommandée
#deployments - Annonces de déploiement et approbations
#incidents - Rapports d'incidents et suivi
#drift-alerts - Notifications de dérive de configuration
#general - Résumés quotidiens (optionnel)# Quotidien à 8h
TRACKER_SLACK_CRON_MESSAGE="0 8 * * *"
# Jours de semaine à 9h
TRACKER_SLACK_CRON_MESSAGE="0 9 * * 1-5"
# Toutes les 2 heures pendant les heures de bureau
TRACKER_SLACK_CRON_MESSAGE="0 9-17/2 * * 1-5"┌─────────────────────────────────────────────────────────────┐
│ Workspace Slack │
│ /deployment /incident │
│ /drift /rpa_usage │
└────────────────────────┬────────────────────────────────────┘
│ Commandes Slash & Interactions
│
┌────────▼────────┐
│ Tracker Slack │
│ (Service Go) │
│ │
│ ┌─────────────┐ │
│ │ Gestionnaire│ │
│ │ API Slack │ │
│ └─────────────┘ │
│ ┌─────────────┐ │
│ │ Générateur │ │
│ │ de Modales │ │
│ └─────────────┘ │
│ ┌─────────────┐ │
│ │ Planificateur│ │
│ │ Cron │ │
│ └─────────────┘ │
└────────┬────────┘
│ Appels API REST
│
┌────────▼────────┐
│ API Tracker │
│ (Service Principal) │
│ │
│ ┌─────────────┐ │
│ │ API Event │ │
│ └─────────────┘ │
│ ┌─────────────┐ │
│ │ API Catalog │ │
│ └─────────────┘ │
└────────┬────────┘
│
┌────────▼────────┐
│ Base de │
│ Données │
│ (MongoDB) │
└─────────────────┘
- Commandes Slack → L'utilisateur tape
/deploymentdans Slack - API Slack → Envoie un webhook au service Tracker Slack
- Génération de Modale → Crée un formulaire interactif basé sur le type d'événement
- Saisie Utilisateur → L'utilisateur remplit le formulaire et soumet
- Intégration API → Tracker Slack appelle l'API Tracker
- Création d'Événement → Événement stocké dans la base de données Tracker
- Réponse Slack → Message formaté posté dans le canal approprié
- Mises à jour Interactives → Les utilisateurs peuvent modifier/mettre à jour via des boutons
- Résumés Quotidiens → Le job cron récupère et poste les événements quotidiens
Dans Slack :
/deployment
Cela ouvre une modale interactive où vous pouvez remplir :
- Résumé : "Déployer user-service v2.1.0 en production"
- Projet : Sélectionner dans le menu déroulant (récupéré depuis le catalogue Tracker)
- Environnement : PROD, PREP, UAT, ou DEV
- Impact : Oui/Non
- Date de Début : Sélecteur de date/heure
- Parties Prenantes : Sélecteur multi-utilisateurs
- Ticket : Lien vers le ticket Jira/GitHub
- Pull Request : Lien vers la PR GitHub
- Description : Notes détaillées du déploiement
Résultat : Un message formaté est posté dans le canal de déploiement avec des boutons interactifs pour l'approbation, l'édition et les mises à jour de statut.
Dans Slack :
/incident
La modale inclut :
- Résumé : "API Gateway retourne des erreurs 500"
- Projet : "api-gateway"
- Environnement : PROD
- Priorité : P1, P2, P3, ou P4
- Parties Prenantes : Membres de l'équipe d'astreinte
- Ticket : Lien vers le système de gestion d'incidents
- Description : Description détaillée de l'incident
Résultat : Posté dans le canal d'incidents avec bouton de fermeture et suivi automatique du statut.
Dans Slack :
/drift
Cas d'usage : L'équipe infrastructure détecte des changements manuels en production
- Résumé : "Changements manuels de groupe de sécurité détectés"
- Projet : "infrastructure"
- Environnement : PROD
- Description : Détails sur la dérive
Dans Slack :
/rpa_usage
Cas d'usage : Documenter l'exécution d'automatisation
- Résumé : "Lot de traitement de factures terminé"
- Environnement : PROD
- Date de Début : Heure d'exécution
- Description : "150 factures traitées, 2 échecs nécessitant une révision manuelle"
Après avoir créé un événement, les membres de l'équipe peuvent interagir avec celui-ci en utilisant des boutons et des menus déroulants.
Actions Disponibles :
Modifier l'Événement : Cliquez sur le bouton "✏️ Modifier" Approuver le Déploiement : Cliquez sur "✅ Approbation" pour approuver le déploiement Mettre à jour le Statut : Utilisez le menu déroulant pour changer le statut :
- 🔄 EnCours
- ⏸️ Pause
- ❌ Annulé
- ⏳ Reporté
- ✅ Terminé
Mises à jour de Statut : Réponses automatiques en fil et réactions emoji montrent le statut actuel.
Automatisé à 8h (configurable) :
📅 Événements Tracker d'Aujourd'hui :
🏭 PROD
user-service:
- 09:00 CET - Déployer user-service v2.1.0 en production [fil]
- 14:30 CET - Déploiement hotfix pour bug critique [fil]
🧪 UAT
payment-service:
- 10:00 CET - Déployer payment-service v1.5.0 pour test [fil]
Les événements se lient automatiquement vers Tracker :
- ID de Message Slack stocké dans Tracker
- Liens directs dans les résumés quotidiens
- Synchronisation bidirectionnelle entre plateformes
- Langage : Go 1.22.7+
- Intégration Slack : slack-go/slack v0.16.0
- Planification : robfig/cron v3.0.1
- Serveur HTTP : Bibliothèque standard Go
- Intégration API : Client REST pour l'API Tracker
- Commandes Slash :
/deployment,/incident,/drift,/rpa_usage - Composants Interactifs : Modales, boutons, menus déroulants, sélecteurs de date
- Block Kit : Formatage de messages riches avec le Block Kit de Slack
- Webhooks : Vérification de signature et analyse de payload
- Mises à jour Temps Réel : Édition de messages et réponses en fil
- Conteneurisation : Docker avec builds multi-étapes
- Orchestration : Déploiement Kubernetes
- Chart Helm : Chart Helm prêt pour la production inclus
- Configuration : Variables d'environnement et secrets Kubernetes
- Monitoring : Journalisation structurée pour l'observabilité
- API Tracker : Intégration RESTful avec le service Tracker principal
- Mappage d'Événements : Mappage complet des champs entre Slack et Tracker
- Support de Fuseau Horaire : Gestion configurable des fuseaux horaires
- Planification Cron : Planification flexible avec expressions cron
- ✅ Commandes Slack : Prêt pour la production - Les 4 commandes slash implémentées
- ✅ Modales Interactives : Prêt pour la production - Formulaires riches pour la création d'événements
- ✅ Gestion d'Événements : Prêt pour la production - Créer, modifier, mettre à jour les événements
- ✅ Résumés Quotidiens : Prêt pour la production - Rapports automatisés basés sur cron
- ✅ Docker : Prêt pour la production - Builds Docker multi-étapes
- ✅ Kubernetes : Prêt pour la production - Chart Helm avec support ingress
- ✅ Intégration Tracker : Prêt pour la production - Intégration API complète
- 🚧 Validation Webhook : Fonctionnalités de sécurité avancées planifiées
- 🚧 Workflows Avancés : Processus d'approbation multi-étapes planifiés
Nous accueillons les contributions pour améliorer Tracker Slack ! Voici comment vous pouvez aider :
- 🐛 Signaler des Bugs : Ouvrir une issue
- 💡 Suggérer des Fonctionnalités : Démarrer une discussion
- 📝 Améliorer la Documentation : Soumettre des améliorations de documentation
- 🔧 Soumettre des PRs : Corriger des bugs ou ajouter des fonctionnalités
# Cloner le dépôt
git clone https://github.com/BananaOps/tracker-slack.git
cd tracker-slack
# Installer les dépendances
go mod download
# Configurer les variables d'environnement (voir section Configuration)
cp .env.example .env
# Éditer .env avec vos valeurs
# Exécuter localement
go run main.go
# Exécuter les tests
go test ./...
# Formater le code
make fmt
# Linter le code
make lint- Ajouter le support pour plus de composants interactifs Slack
- Améliorer la gestion d'erreurs et les retours utilisateur
- Ajouter des tests unitaires pour la génération de modales
- Améliorer le formatage des résumés quotidiens
- Ajouter le support pour des réactions emoji personnalisées
- Tracker - Plateforme principale de suivi d'événements
- Tracker GitHub Action - Intégration GitHub Actions
- Tracker CLI - Interface en ligne de commande
- GitHub Issues : Signaler des bugs ou demander des fonctionnalités
- GitHub Discussions : Poser des questions et partager des idées
- Projet Principal : Documentation Tracker
Si vous découvrez une vulnérabilité de sécurité, veuillez envoyer un email à security@bananaops.org. Toutes les vulnérabilités de sécurité seront traitées rapidement.
Fait avec ❤️ par la communauté BananaOps
⭐ Donnez-nous une étoile sur GitHub • 🐛 Signaler un Bug • 💬 Rejoindre la Discussion