Deploy your app

• How-to guide
• 1-min read

Permissions

To deploy your Dynatrace app, you need the following IAM permissions:

• app-engine:apps:install
• app-engine:apps:run

If you're planning to uninstall it completely, you might also need the following permission:

• app-engine:apps:delete

Deploy from a local device

1. Ensure your user has the required IAM permissions.
2. Navigate to the root of your project.
3. Run the following command in your terminal:

npx dt-app deploy

Deploy from a CI/CD pipeline

1. Create an OAuth client that has the required IAM permissions.
2. In your CI/CD pipeline, set the environment variables DT_APP_OAUTH_CLIENT_ID and DT_APP_OAUTH_CLIENT_SECRET with the generated client ID and client secret.
3. Run the following command within your pipeline:

npx dt-app deploy

Examples

Jenkins

Jenkinsfile

pipeline {
  // Replace the following lines with a Docker or Kubernetes agent with an image with node v24
  agent {
    kubernetes {
      // Example of a Kubernetes agent
      cloud 'linux-amd64'
      yaml """
      kind: Pod
      spec:
        containers:
          - name: nodejs
            image: node24
            args:
              - cat
            tty: true
      """
      defaultContainer 'nodejs'
    }
  }

  stages {
    stage('Install') {
      steps {
        sh('npm ci')
      }
    }

    stage('Lint') {
      steps {
        sh 'npm run lint'
      }
    }

    stage('Build') {
      steps {
        sh('npx dt-app build')
      }
    }

    stage('Deploy') {
      steps {
        sh('npx dt-app deploy --skip-build')
      }
    }
  }
}

Github Actions

.github/workflows/main.yml

name: CI

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v2

      - name: Setup Node
        uses: actions/setup-node@v2
        with:
          node-version: '24'

      - name: Install
        run: npm ci

      - name: Lint
        run: npm run lint

      - name: Build
        run: npx dt-app build

      - name: Deploy
        run: npx dt-app deploy --skip-build

Gitlab

.gitlab-ci.yml

default:
  image: node:24

stages:
  - install
  - lint
  - build
  - deploy

install:
  stage: install
  script:
    - npm ci
  artifacts:
    paths:
      - node_modules/

lint:
  stage: lint
  script:
    - npm run lint

build:
  stage: build
  script:
    - npx dt-app build
  artifacts:
    paths:
      - .dt-app
      - dist

deploy:
  stage: deploy
  script:
    - npx dt-app deploy --skip-build

Note

Every time you modify the app.config.json file, you must increase the version number in the file before re-deploying the app.

If you don't increase the version number, you need to uninstall the current deployed version.

Uninstall the app

1. Ensure your user or the OAuth token used on the CI/CD pipeline has the app-engine:apps:delete permission.
2. Run the following command in your terminal:

npx dt-app uninstall