Integrations

Aperture integrates with your existing development and operational tools to create a seamless workflow for web-to-native deployments. This guide covers the available integrations and how to set them up.

CI/CD Integrations

Automate your deployments by integrating Aperture with your continuous integration and delivery systems:

GitHub Actions

Trigger deployments automatically when you push to specific branches or create new tags.

Example workflow:

name: Deploy to Aperture

on:
  push:
    branches: [ main, production ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '16'
      - run: npm ci
      - run: npm run build
      - name: Deploy to Aperture
        uses: triptech/aperture-deploy-action@v1
        with:
          api-key: [secrets.APERTURE_API_KEY]
          app-id: [secrets.APERTURE_APP_ID]
          build-dir: 'dist'

GitLab CI

Integrate Aperture deployments into your GitLab CI/CD pipelines.

Example configuration:

stages:
  - build
  - deploy

build:
  stage: build
  image: node:16
  script:
    - npm ci
    - npm run build
  artifacts:
    paths:
      - dist/

deploy_to_aperture:
  stage: deploy
  image: triptech/aperture-cli:latest
  script:
    - aperture-cli deploy 
      --api-key $APERTURE_API_KEY 
      --app-id $APERTURE_APP_ID 
      --build-dir dist

CircleCI

Set up automatic deployments using CircleCI pipelines.

Setup Instructions:

1. Add APERTURE_API_KEY to your CircleCI project’s environment variables
2. Include the Aperture deployment Orb in your config.yml
3. Configure the deployment job in your workflow

Azure DevOps

Integrate Aperture deployments into your Azure pipelines.

Available Tasks:

• Aperture Deploy: Deploy a build to your native applications
• Aperture Monitor: Track deployment progress and status
• Aperture Rollback: Quickly revert to a previous version

Monitoring & Analytics Integrations

Connect Aperture with your monitoring and analytics tools to gain deeper insights into your deployments:

Datadog

Send deployment events and metrics to your Datadog dashboards.

Configuration Steps:

1. Obtain your Datadog API key from your Datadog account
2. Navigate to Aperture Settings → Integrations → Datadog
3. Enter your Datadog API key and select the metrics to send
4. Choose which events should trigger Datadog notifications

Available Metrics:

• Deployment frequency and duration
• User adoption rates
• Error rates by deployment
• Performance metrics before and after deployments

New Relic

Track deployment markers and performance in your New Relic dashboards.

Benefits:

• Correlate application performance with specific deployments
• Create deployment markers on performance charts
• Set up alerts based on post-deployment metrics
• Track user experience across deployment changes

Google Analytics

Correlate user behavior with your deployment cycles.

Integration Features:

• Automatically tag sessions with deployment version
• Create custom dimensions for deployment cohorts
• Compare user engagement metrics across deployments
• Track conversion rates before and after updates

Communication & Notification Integrations

Keep your team informed about deployment activities and status changes:

Slack

Receive real-time notifications about deployments in your Slack channels.

Notification Types:

• Deployment started/completed
• Deployment phase transitions
• Rollback events
• Error rate threshold alerts
• Approval requests (Enterprise)

Email Notifications

Configure email alerts for important deployment events.

Configuration Options:

• Select which events trigger notifications
• Customize notification templates
• Set up notification groups by team or role
• Schedule daily/weekly deployment summary reports

Custom Webhooks

Integrate Aperture with any system that supports webhook notifications.

Implementation:

1. Navigate to Settings → Integrations → Webhooks
2. Add a new webhook with your endpoint URL
3. Select which events should trigger the webhook
4. Configure authentication (Basic, Bearer, or Custom)
5. Test the webhook connection

Microsoft Teams

Send deployment notifications and updates to Microsoft Teams channels.

Features:

• Interactive deployment cards with status updates
• Actionable buttons for approvals (Enterprise)
• Deployment statistics and metrics summaries
• Error and warning notifications

Setting Up New Integrations

To configure any of the available integrations:

1. Access Integrations Page Navigate to your organization settings and select the “Integrations” tab.

2. Select Integration Type Choose the integration you want to set up from the available options.

3. Configure Integration Settings Enter the required credentials and select the events or data you want to include.

4. Test the Integration Use the “Test Connection” button to verify that everything is working correctly.

5. Save and Activate Once tested, save your configuration to activate the integration.

Integration Best Practices

To get the most out of your integrations:

• Start with a minimal set of notifications to avoid alert fatigue
• Create separate notification channels for different teams or application groups
• Use detailed notifications for critical deployments and summaries for routine updates
• Regularly review and adjust your notification settings based on team feedback