Skip to content

Latest commit

 

History

History
899 lines (760 loc) · 49.2 KB

File metadata and controls

899 lines (760 loc) · 49.2 KB

terraform-azurerm-avm-res-app-containerapp

This is a template repo for Terraform Azure Verified Container App Modules.

This module DOES NOT contain other Container App related resource, including azurerm_container_app_environment.

Requirements

The following requirements are needed by this module:

Resources

The following resources are used by this module:

Required Inputs

The following input variables are required:

Description: The ID of the Container App Environment to host this Container App.

Type: string

Description: The name for this Container App.

Type: string

Description: (Required) The name of the resource group in which the Container App Environment is to be created. Changing this forces a new resource to be created.

Type: string

Description: (Required) The revisions operational mode for the Container App. Possible values include Single and Multiple. In Single mode, a single revision is in operation at any given time. In Multiple mode, more than one revision can be active at a time and can be configured with load distribution via the traffic_weight block in the ingress configuration.

Type: string

Description: - max_replicas - (Optional) The maximum number of replicas for this container.

  • min_replicas - (Optional) The minimum number of replicas for this container.
  • revision_suffix - (Optional) The suffix for the revision. This value must be unique for the lifetime of the Resource. If omitted the service will use a hash function to create one.

azure_queue_scale_rule block supports the following:

  • name - (Required) The name of the Scaling Rule
  • queue_length - (Required) The value of the length of the queue to trigger scaling actions.
  • queue_name - (Required) The name of the Azure Queue

authentication block supports the following:

  • secret_name - (Required) The name of the Container App Secret to use for this Scale Rule Authentication.
  • trigger_parameter - (Required) The Trigger Parameter name to use the supply the value retrieved from the secret_name.

container block supports the following:

  • args - (Optional) A list of extra arguments to pass to the container.
  • command - (Optional) A command to pass to the container to override the default. This is provided as a list of command line elements without spaces.
  • cpu - (Required) The amount of vCPU to allocate to the container. Possible values include 0.25, 0.5, 0.75, 1.0, 1.25, 1.5, 1.75, and 2.0. When there's a workload profile specified, there's no such constraint.
  • image - (Required) The image to use to create the container.
  • memory - (Required) The amount of memory to allocate to the container. Possible values are 0.5Gi, 1Gi, 1.5Gi, 2Gi, 2.5Gi, 3Gi, 3.5Gi and 4Gi. When there's a workload profile specified, there's no such constraint.
  • name - (Required) The name of the container

env block supports the following:

  • name - (Required) The name of the environment variable for the container.
  • secret_name - (Optional) The name of the secret that contains the value for this environment variable.
  • value - (Optional) The value for this environment variable.

liveness_probe block supports the following:

  • failure_count_threshold - (Optional) The number of consecutive failures required to consider this probe as failed. Possible values are between 1 and 10. Defaults to 3.
  • host - (Optional) The probe hostname. Defaults to the pod IP address. Setting a value for Host in headers can be used to override this for HTTP and HTTPS type probes.
  • initial_delay - (Optional) The time in seconds to wait after the container has started before the probe is started.
  • interval_seconds - (Optional) How often, in seconds, the probe should run. Possible values are in the range 1
  • path - (Optional) The URI to use with the host for http type probes. Not valid for TCP type probes. Defaults to /.
  • port - (Required) The port number on which to connect. Possible values are between 1 and 65535.
  • timeout - (Optional) Time in seconds after which the probe times out. Possible values are in the range 1
  • transport - (Required) Type of probe. Possible values are TCP, HTTP, and HTTPS.

header block supports the following:

  • name - (Required) The HTTP Header Name.
  • value - (Required) The HTTP Header value.

readiness_probe block supports the following:

  • failure_count_threshold - (Optional) The number of consecutive failures required to consider this probe as failed. Possible values are between 1 and 10. Defaults to 3.
  • host - (Optional) The probe hostname. Defaults to the pod IP address. Setting a value for Host in headers can be used to override this for HTTP and HTTPS type probes.
  • interval_seconds - (Optional) How often, in seconds, the probe should run. Possible values are between 1 and 240. Defaults to 10
  • path - (Optional) The URI to use for http type probes. Not valid for TCP type probes. Defaults to /.
  • port - (Required) The port number on which to connect. Possible values are between 1 and 65535.
  • success_count_threshold - (Optional) The number of consecutive successful responses required to consider this probe as successful. Possible values are between 1 and 10. Defaults to 3.
  • timeout - (Optional) Time in seconds after which the probe times out. Possible values are in the range 1
  • transport - (Required) Type of probe. Possible values are TCP, HTTP, and HTTPS.

header block supports the following:

  • name - (Required) The HTTP Header Name.
  • value - (Required) The HTTP Header value.

startup_probe block supports the following:

  • failure_count_threshold - (Optional) The number of consecutive failures required to consider this probe as failed. Possible values are between 1 and 10. Defaults to 3.
  • host - (Optional) The value for the host header which should be sent with this probe. If unspecified, the IP Address of the Pod is used as the host header. Setting a value for Host in headers can be used to override this for HTTP and HTTPS type probes.
  • interval_seconds - (Optional) How often, in seconds, the probe should run. Possible values are between 1 and 240. Defaults to 10
  • path - (Optional) The URI to use with the host for http type probes. Not valid for TCP type probes. Defaults to /.
  • port - (Required) The port number on which to connect. Possible values are between 1 and 65535.
  • timeout - (Optional) Time in seconds after which the probe times out. Possible values are in the range 1
  • transport - (Required) Type of probe. Possible values are TCP, HTTP, and HTTPS.

header block supports the following:

  • name - (Required) The HTTP Header Name.
  • value - (Required) The HTTP Header value.

volume_mounts block supports the following:

  • name - (Required) The name of the Volume to be mounted in the container.
  • path - (Required) The path in the container at which to mount this volume.

custom_scale_rule block supports the following:

  • custom_rule_type - (Required) The Custom rule type. Possible values include: activemq, artemis-queue, kafka, pulsar, aws-cloudwatch, aws-dynamodb, aws-dynamodb-streams, aws-kinesis-stream, aws-sqs-queue, azure-app-insights, azure-blob, azure-data-explorer, azure-eventhub, azure-log-analytics, azure-monitor, azure-pipelines, azure-servicebus, azure-queue, cassandra, cpu, cron, datadog, elasticsearch, external, external-push, gcp-stackdriver, gcp-storage, gcp-pubsub, graphite, http, huawei-cloudeye, ibmmq, influxdb, kubernetes-workload, liiklus, memory, metrics-api, mongodb, mssql, mysql, nats-jetstream, stan, tcp, new-relic, openstack-metric, openstack-swift, postgresql, predictkube, prometheus, rabbitmq, redis, redis-cluster, redis-sentinel, redis-streams, redis-cluster-streams, redis-sentinel-streams, selenium-grid,solace-event-queue, and github-runner.
  • metadata - (Required)
  • name - (Required) The name of the Scaling Rule

authentication block supports the following:

  • secret_name - (Required) The name of the Container App Secret to use for this Scale Rule Authentication.
  • trigger_parameter - (Required) The Trigger Parameter name to use the supply the value retrieved from the secret_name.

http_scale_rule block supports the following:

  • concurrent_requests - (Required)
  • name - (Required) The name of the Scaling Rule

authentication block supports the following:

  • secret_name - (Required) The name of the Container App Secret to use for this Scale Rule Authentication.
  • trigger_parameter - (Required) The Trigger Parameter name to use the supply the value retrieved from the secret_name.

init_container block supports the following:

  • args - (Optional) A list of extra arguments to pass to the container.
  • command - (Optional) A command to pass to the container to override the default. This is provided as a list of command line elements without spaces.
  • cpu - (Optional) The amount of vCPU to allocate to the container. Possible values include 0.25, 0.5, 0.75, 1.0, 1.25, 1.5, 1.75, and 2.0. When there's a workload profile specified, there's no such constraint.
  • image - (Required) The image to use to create the container.
  • memory - (Optional) The amount of memory to allocate to the container. Possible values are 0.5Gi, 1Gi, 1.5Gi, 2Gi, 2.5Gi, 3Gi, 3.5Gi and 4Gi. When there's a workload profile specified, there's no such constraint.
  • name - (Required) The name of the container

env block supports the following:

  • name - (Required) The name of the environment variable for the container.
  • secret_name - (Optional) The name of the secret that contains the value for this environment variable.
  • value - (Optional) The value for this environment variable.

volume_mounts block supports the following:

  • name - (Required) The name of the Volume to be mounted in the container.
  • path - (Required) The path in the container at which to mount this volume.

tcp_scale_rule block supports the following:

  • concurrent_requests - (Required)
  • name - (Required) The name of the Scaling Rule

authentication block supports the following:

  • secret_name - (Required) The name of the Container App Secret to use for this Scale Rule Authentication.
  • trigger_parameter - (Required) The Trigger Parameter name to use the supply the value retrieved from the secret_name.

volume block supports the following:

  • name - (Required) The name of the volume.
  • storage_name - (Optional) The name of the AzureFile storage.
  • storage_type - (Optional) The type of storage volume. Possible values are AzureFile, EmptyDir and Secret. Defaults to EmptyDir.

Type:

object({
    max_replicas    = optional(number)
    min_replicas    = optional(number)
    revision_suffix = optional(string)
    azure_queue_scale_rules = optional(list(object({
      name         = string
      queue_length = number
      queue_name   = string
      authentication = list(object({
        secret_name       = string
        trigger_parameter = string
      }))
    })))
    containers = list(object({
      args    = optional(list(string))
      command = optional(list(string))
      cpu     = number
      image   = string
      memory  = string
      name    = string
      env = optional(list(object({
        name        = string
        secret_name = optional(string)
        value       = optional(string)
      })))
      liveness_probes = optional(list(object({
        failure_count_threshold = optional(number)
        host                    = optional(string)
        initial_delay           = optional(number)
        interval_seconds        = optional(number)
        path                    = optional(string)
        port                    = number
        timeout                 = optional(number)
        transport               = string
        header = optional(list(object({
          name  = string
          value = string
        })))
      })))
      readiness_probes = optional(list(object({
        failure_count_threshold = optional(number)
        host                    = optional(string)
        interval_seconds        = optional(number)
        path                    = optional(string)
        port                    = number
        success_count_threshold = optional(number)
        timeout                 = optional(number)
        transport               = string
        header = optional(list(object({
          name  = string
          value = string
        })))
      })))
      startup_probe = optional(list(object({
        failure_count_threshold = optional(number)
        host                    = optional(string)
        interval_seconds        = optional(number)
        path                    = optional(string)
        port                    = number
        timeout                 = optional(number)
        transport               = string
        header = optional(list(object({
          name  = string
          value = string
        })))
      })))
      volume_mounts = optional(list(object({
        name = string
        path = string
      })))
    }))
    custom_scale_rules = optional(list(object({
      custom_rule_type = string
      metadata         = map(string)
      name             = string
      authentication = optional(list(object({
        secret_name       = string
        trigger_parameter = string
      })))
    })))
    http_scale_rules = optional(list(object({
      concurrent_requests = string
      name                = string
      authentication = optional(list(object({
        secret_name       = string
        trigger_parameter = optional(string)
      })))
    })))
    init_containers = optional(list(object({
      args    = optional(list(string))
      command = optional(list(string))
      cpu     = optional(number)
      image   = string
      memory  = optional(string)
      name    = string
      env = optional(list(object({
        name        = string
        secret_name = optional(string)
        value       = optional(string)
      })))
      volume_mounts = optional(list(object({
        name = string
        path = string
      })))
    })))
    tcp_scale_rules = optional(list(object({
      concurrent_requests = string
      name                = string
      authentication = optional(list(object({
        secret_name       = string
        trigger_parameter = optional(string)
      })))
    })))
    volumes = optional(list(object({
      name         = string
      storage_name = optional(string)
      storage_type = optional(string)
    })))
  })

Optional Inputs

The following input variables are optional (have default values):

Description: - name - (Required) Name of the Container App AuthConfig.


platform The configuration settings of the platform of ContainerApp Service Authentication/Authorization. The platform block supports the following:

  • enabled - (Optional) true if the Authentication / Authorization feature is enabled for the current app; otherwise, false.
  • runtime_version - (Optional) The RuntimeVersion of the Authentication / Authorization feature in use for the current app. The setting in this value can control the behavior of certain features in the Authentication / Authorization module.

global_validation The configuration settings that determines the validation flow of users using Service Authentication/Authorization. The global_validation block supports the following:

  • unauthenticated_client_action - (Optional) The action to take when an unauthenticated client attempts to access the app. Possible values include AllowAnonymous, RedirectToLoginPage, Return401 and Return403.
  • redirect_to_provider - (Optional) The default authentication provider to use when multiple providers are configured. This setting is only needed if multiple providers are configured and the unauthenticated client action is set to "RedirectToLoginPage".
  • exclude_paths - (Optional) The paths for which unauthenticated flow would not be redirected to the login page.

identity_providers The configuration settings of each of the identity providers used to configure ContainerApp Service Authentication/Authorization. The identity_providers block supports the following:

  • azure_active_directory - (Optional) The configuration settings of the Azure Active directory provider. The azure_active_directory block supports the following:
    • enabled - (Optional) false if the Azure Active Directory provider should not be enabled despite the set registration; otherwise, true.
    • is_auto_provisioned - (Optional) Gets a value indicating whether the Azure AD configuration was auto-provisioned using 1st party tooling. This is an internal flag primarily intended to support the Azure Management Portal. Users should not read or write to this property.
    • registration - (Optional) The registration settings for the Azure Active Directory provider. The registration block supports the following:
      • open_id_issuer - (Optional) The OpenID Connect Issuer URI that represents the entity which issues access tokens for this application. When using Azure Active Directory, this value is the URI of the directory tenant, e.g. https://login.microsoftonline.com/v2.0/{tenant-guid}/. This URI is a case-sensitive identifier for the token issuer. More information on OpenID Connect Discovery: http://openid.net/specs/openid-connect-discovery-1_0.html
      • client_id - (Optional) The Client ID of this relying party application, known as the client_id. This setting is required for enabling OpenID Connection authentication with Azure Active Directory or other 3rd party OpenID Connect providers. More information on OpenID Connect: http://openid.net/specs/openid-connect-core-1_0.html
      • client_secret_setting_name - (Optional) The app setting name that contains the client secret of the relying party application.
      • client_secret_certificate_issuer - (Optional) An alternative to the client secret thumbprint, that is the issuer of a certificate used for signing purposes. This property acts as a replacement for the Client Secret Certificate Thumbprint. It is also optional.
      • client_secret_certificate_subject_alternative_name - (Optional) An alternative to the client secret thumbprint, that is the subject alternative name of a certificate used for signing purposes. This property acts as a replacement for the Client Secret Certificate Thumbprint. It is also optional.
    • login - (Optional) The login settings for the Azure Active Directory provider. The login block supports the following:
      • login_parameters - (Optional) Login parameters to send to the OpenID Connect authorization endpoint when a user logs in. Each parameter must be in the form "key=value".
      • disable_www_authenticate - (Optional) true if the www-authenticate provider should be omitted from the request; otherwise, false.
    • validation - (Optional) The configuration settings of the Azure Active Directory token validation flow. The validation block supports the following:
      • jwt_claim_checks - (Optional) The configuration settings of the checks that should be made while validating the JWT Claims. The jwt_claim_checks block supports the following:
        • allowed_groups - (Optional) The list of the allowed groups.
        • allowed_client_applications - (Optional) The list of the allowed client applications.
      • allowed_audiences - (Optional) The list of audiences that can make successful authentication/authorization requests.
      • default_authorization_policy - (Optional) The configuration settings of the default authorization policy. The default_authorization_policy block supports the following:
        • allowed_applications - (Optional) The configuration settings of the Azure Active Directory allowed applications.
        • allowed_principals - (Optional) The configuration settings of the Azure Active Directory allowed principals. The allowed_principals block supports the following:
          • groups - (Optional) The list of the allowed groups.
          • identities - (Optional) The list of the allowed identities.
  • facebook - (Optional) The configuration settings of the Facebook provider. The facebook block supports the following:
    • enabled - (Optional) false if the Facebook provider should not be enabled despite the set registration; otherwise, true.
    • graph_api_version - (Optional) The version of the Facebook api to be used while logging in.
    • registration - (Optional) The configuration settings of the app registration for the Facebook provider. The registration block supports the following:
      • app_id - (Optional) The App ID of the app used for login.
      • app_secret_setting_name - (Optional) The app setting name that contains the app secret.
    • login - (Optional) The configuration settings of the login flow. The login block supports the following:
      • scopes - (Optional) A list of the scopes that should be requested while authenticating.
  • github - (Optional) The configuration settings of the GitHub provider. The github block supports the following:
    • enabled - (Optional) false if the GitHub provider should not be enabled despite the set registration; otherwise, true.
    • registration - (Optional) The configuration settings of the app registration for the GitHub provider. The registration block supports the following:
      • client_id - (Optional) The Client ID of the app used for login.
      • client_secret_setting_name - (Optional) The app setting name that contains the client secret.
    • login - (Optional) The configuration settings of the login flow. The login block supports the following:
      • scopes - (Optional) A list of the scopes that should be requested while authenticating.
  • google - (Optional) The configuration settings of the Google provider.
    • enabled - (Optional) false if the Google provider should not be enabled despite the set registration; otherwise, true.
    • registration - (Optional) The configuration settings of the app registration for the Google provider. The registration block supports the following:
      • client_id - (Optional) The Client ID of the app used for login.
      • client_secret_setting_name - (Optional) The app setting name that contains the client secret.
    • login - (Optional) The configuration settings of the login flow. The login block supports the following:
      • scopes - (Optional) A list of the scopes that should be requested while authenticating.
    • validation - (Optional) The configuration settings of the Azure Active Directory token validation flow. The validation block supports the following:
      • allowed_audiences - (Optional) The configuration settings of the allowed list of audiences from which to validate the JWT token.
  • twitter - (Optional) The configuration settings of the Twitter provider. The twitter block supports the following:
    • enabled - (Optional) false if the Twitter provider should not be enabled despite the set registration; otherwise, true.
    • registration - (Optional) The configuration settings of the app registration for the Twitter provider. The registration block supports the following:
      • consumer_key - (Required) The OAuth 1.0a consumer key of the Twitter application used for sign-in. This setting is required for enabling Twitter Sign-In. Twitter Sign-In documentation: https://dev.twitter.com/web/sign-in
      • consumer_secret_setting_name - (Optional) The app setting name that contains the OAuth 1.0a consumer secret of the Twitter application used for sign-in.
  • apple - (Optional) The configuration settings of the Apple provider. The apple block supports the following:
    • enabled - (Optional) false if the Apple provider should not be enabled despite the set registration; otherwise, true.
    • registration - (Optional) The configuration settings of the Apple registration. The registration block supports the following:
      • client_id - (Optional) The Client ID of the app used for login.
      • client_secret_setting_name - (Optional) The app setting name that contains the client secret.
    • login - (Optional) The configuration settings of the login flow. The login block supports the following:
      • scopes - (Optional) A list of the scopes that should be requested while authenticating.
  • azure_static_web_apps - (Optional) The configuration settings of the Azure Static Web Apps provider. The azure_static_web_apps block supports the following:
    • enabled - (Optional) false if the Azure Static Web Apps provider should not be enabled despite the set registration; otherwise, true.
    • registration - (Optional) The configuration settings of the Azure Static Web Apps registration. The registration block supports the following:
      • client_id - (Optional) The Client ID of the app used for login.
  • custom_open_id_connect_providers - (Optional) The map of the name of the alias of each custom Open ID Connect provider to the configuration settings of the custom Open ID Connect provider. The custom_open_id_connect_providers's value supports the following:
    • enabled - (Optional) false if the custom Open ID provider provider should not be enabled; otherwise, true.
    • registration - (Optional) The configuration settings of the app registration for the custom Open ID Connect provider. The registration block supports the following:
      • client_id - (Optional) The client id of the custom Open ID Connect provider.
      • client_credential - (Optional) The authentication credentials of the custom Open ID Connect provider. The client_credential block supports the following:
        • method - (Optional) The method that should be used to authenticate the user. Possible values ClientSecretPost.
        • client_secret_setting_name - (Optional) The app setting that contains the client secret for the custom Open ID Connect provider.
      • open_id_connect_configuration - (Optional) The configuration settings of the endpoints used for the custom Open ID Connect provider. The open_id_connect_configuration block supports the following:
        • authorization_endpoint - (Optional) The endpoint to be used to make an authorization request.
        • certification_uri - (Optional) The endpoint that provides the keys necessary to validate the token.
        • issuer - (Optional) The endpoint that issues the token.
        • token_endpoint - (Optional) The endpoint to be used to request a token.
        • well_known_open_id_configuration - (Optional) The endpoint that contains all the configuration endpoints for the provider.
    • login - (Optional) The configuration settings of the login flow of the custom Open ID Connect provider. The login block supports the following:
      • name_claim_type - (Optional) The name of the claim that contains the users name.
      • scopes - (Optional) A list of the scopes that should be requested while authenticating.

login - The configuration settings of the login flow of users using ContainerApp Service Authentication/Authorization. The login block supports the following:

  • routes - (Optional) The routes that specify the endpoints used for login and logout requests. The routes block supports the following:
    • logout_endpoint - (Optional) The endpoint at which a logout request should be made.
  • token_store - (Optional) The configuration settings of the token store. The token_store block supports the following:
    • enabled - (Optional) true to durably store platform-specific security tokens that are obtained during login flows; otherwise, false.
    • token_refresh_extension_hours - (Optional) The number of hours after session token expiration that a session token can be used to call the token refresh API
    • azure_blob_storage - (Optional) The configuration settings of the storage of the tokens if blob storage is used. The azure_blob_storage block supports the following:
      • sas_url_setting_name - (Required) The name of the app secrets containing the SAS URL of the blob storage containing the tokens.
  • preserve_url_fragments_for_logins - (Optional) true if the fragments from the request are preserved after the login request is made; otherwise, false.
  • allowed_external_redirect_urls - (Optional) External URLs that can be redirected to as part of logging in or logging out of the app. Note that the query string part of the URL is ignored. This is an advanced setting typically only needed by Windows Store application backends. Note that URLs within the current domain are always implicitly allowed.
  • cookie_expiration - (Optional) The configuration settings of the session cookie's expiration. The cookie_expiration block supports the following:
    • convention - (Optional) The convention used when determining the session cookie's expiration.
    • time_to_expiration - (Optional) The time after the request is made when the session cookie should expire.
  • nonce - (Optional) The configuration settings of the nonce used in the login flow. The nonce block supports the following:
    • validate_nonce - (Optional) true if the nonce should not be validated while completing the login flow; otherwise, false.
    • nonce_expiration_interval - (Optional) The time after the request is made when the nonce should expire.

Type:

map(object({
    name = string
    platform = optional(object({
      enabled         = optional(bool)
      runtime_version = optional(string)
    }))
    global_validation = optional(object({
      unauthenticated_client_action = optional(string)
      redirect_to_provider          = optional(string)
      exclude_paths                 = optional(list(string))
    }))
    identity_providers = optional(object({
      azure_active_directory = optional(object({
        enabled = optional(bool)
        registration = optional(object({
          open_id_issuer                                     = optional(string)
          client_id                                          = optional(string)
          client_secret_setting_name                         = optional(string)
          client_secret_certificate_issuer                   = optional(string)
          client_secret_certificate_subject_alternative_name = optional(string)
          client_secret_certificate_thumbprint               = optional(string)
        }))
        login = optional(object({
          login_parameters         = list(string)
          disable_www_authenticate = bool
        }))
        validation = optional(object({
          jwt_claim_checks = optional(object({
            allowed_groups              = optional(list(string))
            allowed_client_applications = optional(list(string))
          }))
          allowed_audiences = optional(list(string))
          default_authorization_policy = optional(object({
            allowed_principals = optional(object({
              groups     = optional(list(string))
              identities = optional(list(string))
            }))
            allowed_applications = optional(list(string))
          }))
        }))
        is_auto_provisioned = optional(bool)
      }))
      facebook = optional(object({
        enabled = optional(bool)
        registration = optional(object({
          app_id                  = optional(string)
          app_secret_setting_name = optional(string)
        }))
        graph_api_version = optional(string)
        login = optional(object({
          scopes = list(string)
        }))
      }))
      github = optional(object({
        enabled = optional(bool)
        registration = optional(object({
          client_id                  = optional(string)
          client_secret_setting_name = optional(string)
        }))
        login = optional(object({
          scopes = list(string)
        }))
      }))
      google = optional(object({
        enabled = optional(bool)
        registration = optional(object({
          client_id                  = optional(string)
          client_secret_setting_name = optional(string)
        }))
        login = optional(object({
          scopes = list(string)
        }))
        validation = optional(object({
          allowed_audiences = list(string)
        }))
      }))
      twitter = optional(object({
        enabled = optional(bool)
        registration = optional(object({
          consumer_key                 = string
          consumer_secret_setting_name = optional(string)
        }))
      }))
      apple = optional(object({
        enabled = optional(bool)
        registration = optional(object({
          client_id                  = string
          client_secret_setting_name = optional(string)
        }))
        login = optional(object({
          scopes = list(string)
        }))
      }))
      azure_static_web_apps = optional(object({
        enabled = optional(bool)
        registration = optional(object({
          client_id = string
        }))
      }))
      custom_open_id_connect_providers = optional(map(object({
        enabled = optional(bool)
        registration = optional(object({
          client_id = optional(string)
          client_credential = optional(object({
            method                     = string
            client_secret_setting_name = string
          }))
          open_id_connect_configuration = optional(object({
            authorization_endpoint           = string
            token_endpoint                   = string
            issuer                           = string
            certification_uri                = string
            well_known_open_id_configuration = optional(string)
          }))
        }))
        login = optional(object({
          name_claim_type = string
          scopes          = list(string)
        }))
      })), {})
    }))
    login = optional(object({
      routes = optional(object({
        logout_endpoint = string
      }))
      token_store = optional(object({
        enabled                       = bool
        token_refresh_extension_hours = number
        azure_blob_storage = optional(object({
          sas_url_setting_name = string
        }))
      }))
      preserve_url_fragments_for_logins = optional(bool)
      allowed_external_redirect_urls    = optional(list(string))
      cookie_expiration = optional(object({
        convention         = optional(string)
        time_to_expiration = optional(string)
      }))
      nonce = optional(object({
        validate_nonce            = bool
        nonce_expiration_interval = string
      }))
    }))
    http_settings = optional(object({
      require_https = optional(bool)
      forward_proxy = optional(object({
        convention               = optional(string)
        custom_host_header_name  = optional(string)
        custom_proto_header_name = optional(string)
      }))
      routes = optional(object({
        api_prefix = string
      }))
    }))
    encryption_settings = optional(object({
      container_app_auth_encryption_secret_name = optional(string)
      container_app_auth_signing_secret_name    = optional(string)
    }))
  }))

Default: {}

Description: - create - (Defaults to 30 minutes) Used when creating the Container App.

  • delete - (Defaults to 30 minutes) Used when deleting the Container App.
  • read - (Defaults to 5 minutes) Used when retrieving the Container App.
  • update - (Defaults to 30 minutes) Used when updating the Container App.

Type:

object({
    create = optional(string)
    delete = optional(string)
    read   = optional(string)
    update = optional(string)
  })

Default: null

Description: - certificate_binding_type - (Optional) The Certificate Binding type. Possible values include Disabled and SniEnabled. Required with container_app_environment_certificate_id. Changing this forces a new resource to be created.

  • container_app_environment_certificate_id - (Optional) The ID of the Container App Environment Certificate to use. Changing this forces a new resource to be created.
  • name - (Required) The fully qualified name of the Custom Domain. Must be the CN or a named SAN in the certificate specified by the container_app_environment_certificate_id. Changing this forces a new resource to be created.

timeouts block supports the following:

  • create - (Defaults to 30 minutes) Used when creating the Container App.
  • delete - (Defaults to 30 minutes) Used when deleting the Container App.
  • read - (Defaults to 5 minutes) Used when retrieving the Container App.

Type:

map(object({
    certificate_binding_type                 = optional(string)
    container_app_environment_certificate_id = optional(string)
    name                                     = string
    timeouts = optional(object({
      create = optional(string)
      delete = optional(string)
      read   = optional(string)
    }))
  }))

Default: {}

Description: - app_id - (Required) The Dapr Application Identifier.

  • app_port - (Optional) The port which the application is listening on. This is the same as the ingress port.
  • app_protocol - (Optional) The protocol for the app. Possible values include http and grpc. Defaults to http.

Type:

object({
    app_id       = string
    app_port     = optional(number)
    app_protocol = optional(string)
  })

Default: null

Description: This variable controls whether or not telemetry is enabled for the module.
For more information see https://aka.ms/avm/telemetryinfo.
If it is set to false, then no telemetry will be collected.

Type: bool

Default: true

Description: - allow_insecure_connections - (Optional) Should this ingress allow insecure connections?

  • exposed_port - (Optional) The exposed port on the container for the Ingress traffic.
  • external_enabled - (Optional) Are connections to this Ingress from outside the Container App Environment enabled? Defaults to false.
  • target_port - (Required) The target port on the container for the Ingress traffic.
  • transport - (Optional) The transport method for the Ingress. Possible values are auto, http, http2 and tcp. Defaults to auto.

custom_domain block supports the following:

  • certificate_binding_type - (Optional) The Binding type. Possible values include Disabled and SniEnabled. Defaults to Disabled.
  • certificate_id - (Required) The ID of the Container App Environment Certificate.
  • name - (Required) The hostname of the Certificate. Must be the CN or a named SAN in the certificate.

ip_security_restriction block supports the following:

  • action - (Required) The IP-filter action. Allow or Deny.
  • description - (Optional) Describe the IP restriction rule that is being sent to the container-app.
  • ip_address_range - (Required) The incoming IP address or range of IP addresses (in CIDR notation).
  • name - (Required) Name for the IP restriction rule.

traffic_weight block supports the following:

  • label - (Optional) The label to apply to the revision as a name prefix for routing traffic.
  • latest_revision - (Optional) This traffic Weight applies to the latest stable Container Revision. At most only one traffic_weight block can have the latest_revision set to true.
  • percentage - (Required) The percentage of traffic which should be sent this revision.
  • revision_suffix - (Optional) The suffix string to which this traffic_weight applies.

Type:

object({
    allow_insecure_connections = optional(bool)
    exposed_port               = optional(number)
    external_enabled           = optional(bool)
    target_port                = number
    transport                  = optional(string)
    custom_domain = optional(object({
      certificate_binding_type = optional(string)
      certificate_id           = string
      name                     = string
    }))
    ip_security_restriction = optional(list(object({
      action           = string
      description      = optional(string)
      ip_address_range = string
      name             = string
    })))
    traffic_weight = list(object({
      label           = optional(string)
      latest_revision = optional(bool)
      percentage      = number
      revision_suffix = optional(string)
    }))
  })

Default: null

Description: Controls the Resource Lock configuration for this resource. The following properties can be specified:

  • kind - (Required) The type of lock. Possible values are \"CanNotDelete\" and \"ReadOnly\".
  • name - (Optional) The name of the lock. If not specified, a name will be generated based on the kind value. Changing this forces the creation of a new resource.

Type:

object({
    kind = string
    name = optional(string, null)
  })

Default: null

Description: Controls the Managed Identity configuration on this resource. The following properties can be specified:

  • system_assigned - (Optional) Specifies if the System Assigned Managed Identity should be enabled.
  • user_assigned_resource_ids - (Optional) Specifies a list of User Assigned Managed Identity resource IDs to be assigned to this resource.

Type:

object({
    system_assigned            = optional(bool, false)
    user_assigned_resource_ids = optional(set(string), [])
  })

Default: {}

Description: - identity - (Optional) Resource ID for the User Assigned Managed identity to use when pulling from the Container Registry.

  • password_secret_name - (Optional) The name of the Secret Reference containing the password value for this user on the Container Registry, username must also be supplied.
  • server - (Required) The hostname for the Container Registry.
  • username - (Optional) The username to use for this Container Registry, password_secret_name must also be supplied..

Type:

list(object({
    identity             = optional(string)
    password_secret_name = optional(string)
    server               = string
    username             = optional(string)
  }))

Default: null

Description: A map of role assignments to create on the . The map key is deliberately arbitrary to avoid issues where map keys maybe unknown at plan time.

  • role_definition_id_or_name - The ID or name of the role definition to assign to the principal.
  • principal_id - The ID of the principal to assign the role to.
  • description - (Optional) The description of the role assignment.
  • skip_service_principal_aad_check - (Optional) If set to true, skips the Azure Active Directory check for the service principal in the tenant. Defaults to false.
  • condition - (Optional) The condition which will be used to scope the role assignment.
  • condition_version - (Optional) The version of the condition syntax. Leave as null if you are not using a condition, if you are then valid values are '2.0'.
  • delegated_managed_identity_resource_id - (Optional) The delegated Azure Resource Id which contains a Managed Identity. Changing this forces a new resource to be created. This field is only used in cross-tenant scenario.
  • principal_type - (Optional) The type of the principal_id. Possible values are User, Group and ServicePrincipal. It is necessary to explicitly set this attribute when creating role assignments if the principal creating the assignment is constrained by ABAC rules that filters on the PrincipalType attribute.

Note: only set skip_service_principal_aad_check to true if you are assigning a role to a service principal.

Type:

map(object({
    role_definition_id_or_name             = string
    principal_id                           = string
    description                            = optional(string, null)
    skip_service_principal_aad_check       = optional(bool, false)
    condition                              = optional(string, null)
    condition_version                      = optional(string, null)
    delegated_managed_identity_resource_id = optional(string, null)
    principal_type                         = optional(string, null)
  }))

Default: {}

Description: - identity - (Optional) The identity to use for accessing the Key Vault secret reference. This can either be the Resource ID of a User Assigned Identity, or System for the System Assigned Identity.

  • key_vault_secret_id - (Optional) The ID of a Key Vault secret. This can be a versioned or version-less ID.
  • name - (Required) The secret name.
  • value - (Optional) The value for this secret.

Type:

map(object({
    identity            = optional(string)
    key_vault_secret_id = optional(string)
    name                = string
    value               = optional(string)
  }))

Default: null

Description: (Optional) A mapping of tags to assign to the Container App.

Type: map(string)

Default: null

Description: (Optional) The name of the Workload Profile in the Container App Environment to place this Container App.

Type: string

Default: null

Outputs

The following outputs are exported:

Description: https url that contains ingress's fqdn, could be used to access the deployed app.

Description: azurerm_container_app resource created by this module.

Description: Resource ID of azurerm_container_app resource created by this module.

Modules

No modules.

Data Collection

The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft’s privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.