Skip to main content

diagrid app create

Create an App

Description​

Create an App in a project.

diagrid app create <app> [flags]

Examples​


  # Create an identity-only App (no endpoint)
  diagrid app create my-app --project my-project

  # Create an App with an endpoint
  diagrid app create my-app --project my-project --endpoint https://myapp.myorg.com/ --endpoint-token xxxxxxxx

  # Create an App with workflow-history archiving enabled
  diagrid app create my-app --project my-project --archive-binding-name archive-store --archive-binding-type bindings.aws.s3 --enable-workflow-archive completed,failed

  # Create an App that raises a notification for failed and stalled workflows
  diagrid app create my-app --project my-project --enable-workflow-notifications FAILED --enable-workflow-notifications STALLED

  # Create an App that loads the Dapr Configuration "tracing-config"
  diagrid app create my-app --project my-project --app-config tracing-config

  # Create an App whose workload pod carries a label and a managed-identity annotation (self-hosted regions only)
  diagrid app create my-app --project my-project --label team=orders --annotation azure.workload.identity/client-id=00000000-0000-0000-0000-000000000000

Options​

  -p, --project string                          Name of existing project
  -e, --endpoint string                         Endpoint used to establish outbound connectivity from the App to your external application
  -t, --endpoint-token string                   Token used to secure calls from the App to your provided endpoint
      --endpoint-protocol string                Protocol used to interact with the endpoint: http (default) or grpc
      --max-body-size string                    Maximum request body size (e.g. "4Mi", "16Mi")
      --app-channel-timeout-seconds int32       Timeout in seconds for the sidecar to connect to the application endpoint
  -c, --app-config string                       Name of the Dapr Configuration the App loads, e.g. for tracing, access control or feature flags. It is the Configuration "diagrid app access" edits, so Apps bound to the same Configuration share its access rules
      --enable-app-health-check                 Enable application-level health probing
      --app-health-check-path string            Health check endpoint path (e.g. /healthz)
      --app-health-probe-interval int32         Health probe interval in seconds
      --app-health-probe-timeout int32          Health probe timeout in milliseconds
      --app-health-threshold int32              Failure threshold before marking unhealthy
  -w, --wait                                    Wait for long-running resource creation to finish
      --ignore-if-exists                        Exit with success if the App already exists instead of returning an error
      --archive-binding-name string             Output-binding component name to write archived workflow history through. Setting this enables archiving
      --archive-binding-type string             Binding component type for the archive destination (e.g., "bindings.aws.s3")
      --enable-workflow-archive strings         Workflow statuses to archive: COMPLETED, FAILED, TERMINATED. Comma-separated or repeated. Statuses not listed are not archived
      --workflow-notifications-name string      Regular expression the workflow name must match in full for a notification to be raised. Empty matches every workflow
      --enable-workflow-notifications strings   Workflow statuses to raise a notification for: FAILED, TERMINATED, STALLED. Comma-separated or repeated. Statuses not listed raise no notification
      --workflow-notifications-root-only        Only raise notifications for workflows with no parent
      --label stringToString                    Label (key=value) applied to the App's workload pod and service account. Repeatable. Only supported in self-hosted regions (default [])
      --annotation stringToString               Annotation (key=value) applied to the App's workload pod and service account, e.g. for managed identity. Repeatable. Only supported in self-hosted regions (default [])
  -h, --help                                    help for create

Options inherited from parent commands​

      --api-key string   Diagrid Cloud API key

SEE ALSO​

Last updated on