@gradientedge/cdk-utils 9.36.0 → 9.38.0

package/src/lib/azure/.gen/versions.json

@@ -0,0 +1,3 @@
+{
+  "registry.terraform.io/azure/azapi": "2.2.0"
+}

package/src/lib/azure/common/construct.ts

@@ -1,4 +1,5 @@
 import { AzurermProvider } from '@cdktf/provider-azurerm/lib/provider'
+import { AzapiProvider } from '../.gen/providers/azapi/provider'
 import { DataAzurermClientConfig } from '@cdktf/provider-azurerm/lib/data-azurerm-client-config'
 import { AzurermBackend, TerraformStack } from 'cdktf'
 import { Construct } from 'constructs'
@@ -13,6 +14,8 @@ import {
   AzureApplicationInsightsManager,
   AzureAppConfigurationManager,
   AzureCosmosDbManager,
+  AzureServicebusManager,
+  AzureEventgridManager,
 } from '../services'
 import { CommonAzureStackProps } from './types'
 import { AzureRemoteBackend } from './constants'
@@ -31,6 +34,8 @@ export class CommonAzureConstruct extends TerraformStack {
   keyVaultManager: AzureKeyVaultManager
   resourceGroupManager: AzureResourceGroupManager
   storageManager: AzureStorageManager
+  servicebusManager: AzureServicebusManager
+  eventgridManager: AzureEventgridManager
 
   constructor(scope: Construct, id: string, props: CommonAzureStackProps) {
     super(scope, id)
@@ -46,11 +51,14 @@ export class CommonAzureConstruct extends TerraformStack {
     this.keyVaultManager = new AzureKeyVaultManager()
     this.resourceGroupManager = new AzureResourceGroupManager()
     this.storageManager = new AzureStorageManager()
+    this.servicebusManager = new AzureServicebusManager()
+    this.eventgridManager = new AzureEventgridManager()
 
     this.determineFullyQualifiedDomain()
     this.determineRemoteBackend()
     this.determineTenantId()
     new AzurermProvider(this, `${this.id}-provider`, this.props)
+    new AzapiProvider(this, `${this.id}-azapi-provider`, this.props)
   }
 
   /**

package/src/lib/azure/services/cosmosdb/main.ts

@@ -2,10 +2,9 @@ import { DataAzurermResourceGroup } from '@cdktf/provider-azurerm/lib/data-azure
 import { CosmosdbAccount } from '@cdktf/provider-azurerm/lib/cosmosdb-account'
 import { CosmosdbSqlDatabase } from '@cdktf/provider-azurerm/lib/cosmosdb-sql-database'
 import { CosmosdbSqlContainer } from '@cdktf/provider-azurerm/lib/cosmosdb-sql-container'
-import { CosmosdbTable } from '@cdktf/provider-azurerm/lib/cosmosdb-table'
 import { CommonAzureConstruct } from '../../common'
 import { createAzureTfOutput } from '../../utils'
-import { CosmosdbAccountProps, CosmosdbTableProps, CosmosdbSqlContainerProps, CosmosdbSqlDatabaseProps } from './types'
+import { CosmosdbAccountProps, CosmosdbSqlContainerProps, CosmosdbSqlDatabaseProps } from './types'
 
 /**
  * @classdesc Provides operations on Azure CosmosDB

package/src/lib/azure/services/cosmosdb/types.ts

@@ -1,9 +1,7 @@
 import { CosmosdbAccountConfig } from '@cdktf/provider-azurerm/lib/cosmosdb-account'
 import { CosmosdbSqlDatabaseConfig } from '@cdktf/provider-azurerm/lib/cosmosdb-sql-database'
 import { CosmosdbSqlContainerConfig } from '@cdktf/provider-azurerm/lib/cosmosdb-sql-container'
-import { CosmosdbTableConfig } from '@cdktf/provider-azurerm/lib/cosmosdb-table'
 
 export interface CosmosdbAccountProps extends CosmosdbAccountConfig {}
 export interface CosmosdbSqlDatabaseProps extends CosmosdbSqlDatabaseConfig {}
 export interface CosmosdbSqlContainerProps extends CosmosdbSqlContainerConfig {}
-export interface CosmosdbTableProps extends CosmosdbTableConfig {}

package/src/lib/azure/services/eventgrid/index.ts

@@ -0,0 +1,2 @@
+export * from './main'
+export * from './types'

package/src/lib/azure/services/eventgrid/main.ts

@@ -0,0 +1,82 @@
+import { DataAzurermResourceGroup } from '@cdktf/provider-azurerm/lib/data-azurerm-resource-group'
+import { EventgridTopic } from '@cdktf/provider-azurerm/lib/eventgrid-topic'
+import { EventgridEventSubscription } from '@cdktf/provider-azurerm/lib/eventgrid-event-subscription'
+import { CommonAzureConstruct } from '../../common'
+import { createAzureTfOutput } from '../../utils'
+import { EventgridTopicProps, EventgridEventSubscriptionProps } from './types'
+
+/**
+ * @classdesc Provides operations on Azure Event Grid
+ * - A new instance of this class is injected into {@link CommonAzureConstruct} constructor.
+ * - If a custom construct extends {@link CommonAzureConstruct}, an instance is available within the context.
+ * @example
+ * ```
+ * import { CommonAzureConstruct, CommonAzureStackProps } from '@gradientedge/cdk-utils'
+ *
+ * class CustomConstruct extends CommonAzureConstruct {
+ *   constructor(parent: Construct, id: string, props: CommonAzureStackProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.EventGridManager.createEventGrid('MyEventGrid', this, props)
+ *   }
+ * }
+ * ```
+ */
+export class AzureEventgridManager {
+  /**
+   * @summary Method to create a new eventgrid topic
+   * @param id scoped id of the resource
+   * @param scope scope in which this resource is defined
+   * @param props eventgrid topic properties
+   * @see [CDKTF Eventgrid Topic Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/eventgridTopic.typescript.md}
+   */
+  public createEventgridTopic(id: string, scope: CommonAzureConstruct, props: EventgridTopicProps) {
+    if (!props) throw `Props undefined for ${id}`
+
+    const resourceGroup = new DataAzurermResourceGroup(scope, `${id}-et-rg`, {
+      name: scope.props.resourceGroupName
+        ? `${scope.props.resourceGroupName}-${scope.props.stage}`
+        : `${props.resourceGroupName}`,
+    })
+
+    if (!resourceGroup) throw `Resource group undefined for ${id}`
+
+    const eventgridTopic = new EventgridTopic(scope, `${id}-et`, {
+      ...props,
+      name: `${props.name}-${scope.props.stage}`,
+      location: resourceGroup.location,
+      resourceGroupName: resourceGroup.name,
+      tags: props.tags ?? {
+        environment: scope.props.stage,
+      },
+    })
+
+    createAzureTfOutput(`${id}-eventgridTopicName`, scope, eventgridTopic.name)
+    createAzureTfOutput(`${id}-eventgridTopicFriendlyUniqueId`, scope, eventgridTopic.friendlyUniqueId)
+    createAzureTfOutput(`${id}-eventgridTopicId`, scope, eventgridTopic.id)
+
+    return eventgridTopic
+  }
+
+  /**
+   * @summary Method to create a new eventgrid subscription
+   * @param id scoped id of the resource
+   * @param scope scope in which this resource is defined
+   * @param props eventgrid subsription properties
+   * @see [CDKTF Eventgrid Subscription Container Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/eventgridEventSubscription.typescript.md}
+   */
+  public createEventgridSubscription(id: string, scope: CommonAzureConstruct, props: EventgridEventSubscriptionProps) {
+    if (!props) throw `Props undefined for ${id}`
+
+    const eventgridSubscription = new EventgridEventSubscription(scope, `${id}-es`, {
+      ...props,
+      name: `${props.name}-${scope.props.stage}`,
+    })
+
+    createAzureTfOutput(`${id}-eventgridSubscriptiontName`, scope, eventgridSubscription.name)
+    createAzureTfOutput(`${id}-eventgridSubscriptionFriendlyUniqueId`, scope, eventgridSubscription.friendlyUniqueId)
+    createAzureTfOutput(`${id}-eventgridSubscriptionId`, scope, eventgridSubscription.id)
+
+    return eventgridSubscription
+  }
+}

package/src/lib/azure/services/eventgrid/types.ts

@@ -0,0 +1,5 @@
+import { EventgridTopicConfig } from '@cdktf/provider-azurerm/lib/eventgrid-topic'
+import { EventgridEventSubscriptionConfig } from '@cdktf/provider-azurerm/lib/eventgrid-event-subscription'
+
+export interface EventgridTopicProps extends EventgridTopicConfig {}
+export interface EventgridEventSubscriptionProps extends EventgridEventSubscriptionConfig {}

package/src/lib/azure/services/function/main.ts

@@ -1,9 +1,10 @@
 import { DataAzurermResourceGroup } from '@cdktf/provider-azurerm/lib/data-azurerm-resource-group'
 import { LinuxFunctionApp } from '@cdktf/provider-azurerm/lib/linux-function-app'
 import { FunctionAppFunction } from '@cdktf/provider-azurerm/lib/function-app-function'
+import { Resource } from '../../.gen/providers/azapi/resource'
 import { CommonAzureConstruct } from '../../common'
 import { createAzureTfOutput } from '../../utils'
-import { FunctionAppProps, FunctionProps } from './types'
+import { FunctionAppProps, FunctionProps, FunctionAppFlexConsumptionProps } from './types'
 
 /**
  * @classdesc Provides operations on Azure Functions
@@ -16,7 +17,7 @@ import { FunctionAppProps, FunctionProps } from './types'
  * class CustomConstruct extends CommonAzureConstruct {
  *   constructor(parent: Construct, id: string, props: CommonAzureStackProps) {
  *     super(parent, id, props)
- *     this.props = props
+ *     this.props: props
  *     this.functionManager.createFunctionApp('MyFunctionApp', this, props)
  *   }
  * }
@@ -79,4 +80,90 @@ export class AzureFunctionManager {
 
     return functionAppFunction
   }
+
+  /**
+   * @summary Method to create a new flex consumption function app
+   * @param id scoped id of the resource
+   * @param scope scope in which this resource is defined
+   * @param props flex consumption function app properties
+   */
+  public createFunctionAppFlexConsumption(
+    id: string,
+    scope: CommonAzureConstruct,
+    props: FunctionAppFlexConsumptionProps
+  ) {
+    if (!props) throw `Props undefined for ${id}`
+
+    const resourceGroup = new DataAzurermResourceGroup(scope, `${id}-fa-rg`, {
+      name: scope.props.resourceGroupName
+        ? `${scope.props.resourceGroupName}-${scope.props.stage}`
+        : `${props.resourceGroupName}`,
+    })
+
+    if (!resourceGroup) throw `Resource group undefined for ${id}`
+
+    const functionApp = new Resource(scope, `${id}-fa`, {
+      type: 'Microsoft.Web/sites@2023-12-01',
+      name: `${props.name}-${scope.props.stage}`,
+      location: resourceGroup.location,
+      parentId: resourceGroup.id,
+
+      body: {
+        kind: props.kind || 'functionapp,linux',
+
+        properties: {
+          serverFarmId: props.appServicePlanId,
+          httpsOnly: props.httpsOnly || true,
+
+          functionAppConfig: {
+            deployment: {
+              storage: {
+                type: props.deploymentStorageType || 'blobContainer',
+                value: `${props.blobEndpoint}${props.containerName}`,
+                authentication: {
+                  type: props.deploymentAuthenticationType || 'StorageAccountConnectionString',
+                  storageAccountConnectionStringName:
+                    props.storageAccountConnectionStringName || 'DEPLOYMENT_STORAGE_CONNECTION_STRING',
+                },
+              },
+            },
+            runtime: {
+              name: props.runtime || 'node',
+              version: props.runtimeVersion || '20',
+            },
+            scaleAndConcurrency: {
+              instanceMemoryMB: props.instanceMemory || 2048,
+              maximumInstanceCount: props.maximumInstanceCount || 40,
+              triggers: {},
+            },
+          },
+
+          siteConfig: {
+            appSettings: props.appSettings.concat([
+              {
+                name: 'FUNCTIONS_EXTENSION_VERSION',
+                value: '~4',
+              },
+              {
+                name: 'AzureWebJobsStorage',
+                value: props.storageConnectionString,
+              },
+              {
+                name: 'DEPLOYMENT_STORAGE_CONNECTION_STRING',
+                value: props.storageConnectionString,
+              },
+            ]),
+          },
+        },
+      },
+
+      identity: [{ type: 'SystemAssigned' }],
+
+      ignoreMissingProperty: true,
+      ignoreCasing: true,
+      schemaValidationEnabled: false,
+    })
+
+    return functionApp
+  }
 }

package/src/lib/azure/services/function/types.ts

@@ -1,7 +1,26 @@
 import { LinuxFunctionAppConfig } from '@cdktf/provider-azurerm/lib/linux-function-app'
 import { FunctionAppFunctionConfig } from '@cdktf/provider-azurerm/lib/function-app-function'
-import { BaseAzureConfigProps } from '../../types'
+import { ResourceConfig } from '../../.gen/providers/azapi/resource'
 
 export interface FunctionAppProps extends LinuxFunctionAppConfig {}
 
 export interface FunctionProps extends FunctionAppFunctionConfig {}
+
+export interface FunctionAppFlexConsumptionProps {
+  appServicePlanId: string
+  appSettings: any
+  blobEndpoint: string
+  containerName: string
+  deploymentAuthenticationType?: string
+  deploymentStorageType?: string
+  httpsOnly?: string
+  instanceMemory?: number
+  kind?: string
+  maximumInstanceCount?: number
+  name: string
+  resourceGroupName: string
+  runtime?: string
+  runtimeVersion?: string
+  storageAccountConnectionStringName?: string
+  storageConnectionString: string
+}

package/src/lib/azure/services/index.ts

@@ -3,7 +3,9 @@ export * from './app-configuration'
 export * from './app-service'
 export * from './application-insights'
 export * from './cosmosdb'
+export * from './eventgrid'
 export * from './function'
 export * from './key-vault'
 export * from './resource-group'
+export * from './servicebus'
 export * from './storage'

package/src/lib/azure/services/servicebus/index.ts

@@ -0,0 +1,2 @@
+export * from './main'
+export * from './types'

package/src/lib/azure/services/servicebus/main.ts

@@ -0,0 +1,68 @@
+import { ServicebusTopic } from '@cdktf/provider-azurerm/lib/servicebus-topic'
+import { ServicebusSubscription } from '@cdktf/provider-azurerm/lib/servicebus-subscription'
+import { CommonAzureConstruct } from '../../common'
+import { createAzureTfOutput } from '../../utils'
+import { ServicebusTopicProps, ServicebusSubscriptionProps } from './types'
+
+/**
+ * @classdesc Provides operations on Azure CosmosDB
+ * - A new instance of this class is injected into {@link CommonAzureConstruct} constructor.
+ * - If a custom construct extends {@link CommonAzureConstruct}, an instance is available within the context.
+ * @example
+ * ```
+ * import { CommonAzureConstruct, CommonAzureStackProps } from '@gradientedge/cdk-utils'
+ *
+ * class CustomConstruct extends CommonAzureConstruct {
+ *   constructor(parent: Construct, id: string, props: CommonAzureStackProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.CosmosDbManager.createCosmosAccount('MyCosmosDb', this, props)
+ *   }
+ * }
+ * ```
+ */
+export class AzureServicebusManager {
+  /**
+   * @summary Method to create a new servicebus topic
+   * @param id scoped id of the resource
+   * @param scope scope in which this resource is defined
+   * @param props servicebus topic properties
+   * @see [CDKTF Servicebus Topic Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/servicebusTopic.typescript.md}
+   */
+  public createServicebusTopic(id: string, scope: CommonAzureConstruct, props: ServicebusTopicProps) {
+    if (!props) throw `Props undefined for ${id}`
+
+    const servicebusTopic = new ServicebusTopic(scope, `${id}-st`, {
+      ...props,
+      name: `${props.name}-${scope.props.stage}`,
+    })
+
+    createAzureTfOutput(`${id}-servicebusTopicName`, scope, servicebusTopic.name)
+    createAzureTfOutput(`${id}-servicebusTopicFriendlyUniqueId`, scope, servicebusTopic.friendlyUniqueId)
+    createAzureTfOutput(`${id}-servicebusTopicId`, scope, servicebusTopic.id)
+
+    return servicebusTopic
+  }
+
+  /**
+   * @summary Method to create a new servicebus subscription
+   * @param id scoped id of the resource
+   * @param scope scope in which this resource is defined
+   * @param props servicebus subscription properties
+   * @see [CDKTF Servicebus Subscription Module]{@link https://github.com/cdktf/cdktf-provider-azurerm/blob/main/docs/servicebusSubscription.typescript.md}
+   */
+  public createServicebusSubscription(id: string, scope: CommonAzureConstruct, props: ServicebusSubscriptionProps) {
+    if (!props) throw `Props undefined for ${id}`
+
+    const servicebusSubscription = new ServicebusSubscription(scope, `${id}-ss`, {
+      ...props,
+      name: `${props.name}-${scope.props.stage}`,
+    })
+
+    createAzureTfOutput(`${id}-servicebusSubscriptionName`, scope, servicebusSubscription.name)
+    createAzureTfOutput(`${id}-servicebusSubscriptionFriendlyUniqueId`, scope, servicebusSubscription.friendlyUniqueId)
+    createAzureTfOutput(`${id}-servicebusSubscriptionId`, scope, servicebusSubscription.id)
+
+    return servicebusSubscription
+  }
+}

package/src/lib/azure/services/servicebus/types.ts

@@ -0,0 +1,5 @@
+import { ServicebusTopicConfig } from '@cdktf/provider-azurerm/lib/servicebus-topic'
+import { ServicebusSubscriptionConfig } from '@cdktf/provider-azurerm/lib/servicebus-subscription'
+
+export interface ServicebusTopicProps extends ServicebusTopicConfig {}
+export interface ServicebusSubscriptionProps extends ServicebusSubscriptionConfig {}

package/src/lib/azure/services/storage/main.ts

@@ -81,14 +81,15 @@ export class AzureStorageManager {
     if (!resourceGroup) throw `Resource group undefined for ${id}`
 
     const storageAccount = new DataAzurermStorageAccount(scope, `${id}-sa`, {
-      name: `${props.storageAccountName}-${scope.props.stage}`,
+      name: `${props.storageAccountName}-${scope.props.stage}`.replace(/\W/g, '').toLowerCase(),
       resourceGroupName: resourceGroup.name,
     })
 
     const storageContainer = new StorageContainer(scope, `${id}-sc`, {
       ...props,
       name: `${props.name}-${scope.props.stage}`,
-      storageAccountName: storageAccount.name,
+      storageAccountName: undefined, // the `storage_account_name` property has been deprecated in favour of `storage_account_id` and will be removed in version 5.0 of the Provider.
+      storageAccountId: storageAccount.id,
     })
 
     createAzureTfOutput(`${id}-storageContainerName`, scope, storageContainer.name)
@@ -123,7 +124,8 @@ export class AzureStorageManager {
 
     const storageContainer = new DataAzurermStorageContainer(scope, `${id}-sc`, {
       name: `${props.storageContainerName}-${scope.props.stage}`,
-      storageAccountName: storageAccount.name,
+      storageAccountName: undefined, // the `storage_account_name` property has been deprecated in favour of `storage_account_id` and will be removed in version 5.0 of the Provider.
+      storageAccountId: storageAccount.id,
     })
 
     const storageBlob = new StorageBlob(scope, `${id}-sb`, {