Microsoft Teams

Warning

Microsoft has deprecated connectors in favor of workflows. Your existing connectors should still work for some time but you won't be able to create new ones with Microsoft Teams. Our product team is working on the integration so that it works with Microsoft Teams Workflows and once that's completed we'll add it to the documentation

Microsoft Teams is a Slack alternative and a part of the Microsoft Office 365 suite. It's a chat-based workspace where teams can organize and discuss their work. Many DevOps teams use it to communicate and collaborate on infrastructure and application deployments. Hence, Spacelift has a first-class integration with Microsoft Teams.

The integration creates a webhook in Spacelift that will send notifications to a Microsoft Teams channel when:

• a tracked run needs confirmation;
• a tracked run or a task finishes;
• a module version succeeds or fails;

Based on this configuration, the module will send notifications that look like these:

Prerequisites

In order to set up the integration, you'll to perform some manual steps in Microsoft Teams. The Spacelift end of the integration is handled programmatically, by a Terraform module.

In Microsoft Teams

In order to set up the integration, you'll need to create a Microsoft Teams webhook and copy its URL. You can do this by following these steps:

1. Open the channel in which you want to receive notifications from Spacelift.
2. Click the ellipsis (...) next to the channel name and select Connectors
3. Search for Incoming Webhook and click Configure.
4. Click Add to create the webhook.
5. Copy the webhook URL, you'll need it in the next step.

In Spacelift

The Teams integration is based on our notification policy feature, which requires at least an active Cloud tier subscription. While building a notification-based Teams integration from scratch is possible, we've created a Terraform module that will set up all the necessary integration elements for you.

This module will only create Spacelift assets:

• a notification policy that will send data to Microsoft Teams;
• a webhook endpoint that serve as a notification target for the policy;

Monitoring and troubleshooting

Once the integration is set up, you can monitor the notifications in the My channel channel in Microsoft Teams. You can also monitor the notifications in the corresponding notification policy and its webhook endpoint in Spacelift.