@studion/infra-code-blocks 0.4.4 → 0.5.1

package/README.md

@@ -58,12 +58,13 @@ $ pulumi up
 
 1. [Project](#project)
 2. [Database](#database)
-3. [Redis](#redis)
-4. [StaticSite](#static-site)
-5. [WebServer](#web-server)
-6. [Nuxt SSR](#nuxt-ssr-preset)
-7. [Mongo](#mongo)
-8. [EcsService](#ecs-service)
+3. [Database Replica](#database-replica)
+4. [Redis](#redis)
+5. [StaticSite](#static-site)
+6. [WebServer](#web-server)
+7. [Nuxt SSR](#nuxt-ssr-preset)
+8. [Mongo](#mongo)
+9. [EcsService](#ecs-service)
 
 ### Project
 
@@ -118,6 +119,7 @@ type DatabaseServiceOptions = {
   maxAllocatedStorage?: pulumi.Input<number>;
   instanceClass?: pulumi.Input<string>;
   enableMonitoring?: pulumi.Input<boolean>;
+  parameterGroupName?: pulumi.Input<string>;
   tags?: pulumi.Input<{
     [key: string]: pulumi.Input<string>;
   }>;
@@ -370,6 +372,7 @@ type DatabaseArgs = {
   maxAllocatedStorage?: pulumi.Input<number>;
   instanceClass?: pulumi.Input<string>;
   enableMonitoring?: pulumi.Input<boolean>;
+  parameterGroupName?: pulumi.Input<string>;
   tags?: pulumi.Input<{
     [key: string]: pulumi.Input<string>;
   }>;
@@ -380,6 +383,46 @@ If the password is not specified it will be autogenerated.
 The database password is stored as a secret inside AWS Secret Manager.
 The secret will be available on the `Database` resource as `password.secret`.
 
+### Database Replica
+
+AWS RDS Postgres instance.
+
+Features:
+
+- enabled encryption with a symmetric encryption key
+- deployed inside an isolated subnet
+
+<br>
+
+```ts
+new DatabaseReplica(name: string, args: DatabaseReplicaArgs, opts?: pulumi.CustomResourceOptions);
+```
+
+| Argument |                  Description                   |
+| :------- | :--------------------------------------------: |
+| name \*  |        The unique name of the resource.        |
+| args \*  |     The arguments to resource properties.      |
+| opts     | Bag of options to control resource's behavior. |
+
+```ts
+type DatabaseReplicaArgs = {
+  replicateSourceDb: pulumi.Input<string>;
+  dbSubnetGroupName: pulumi.Input<string>;
+  dbSecurityGroupId: pulumi.Input<string>;
+  monitoringRole?: aws.iam.Role;
+  multiAz?: pulumi.Input<boolean>;
+  applyImmediately?: pulumi.Input<boolean>;
+  allocatedStorage?: pulumi.Input<number>;
+  maxAllocatedStorage?: pulumi.Input<number>;
+  instanceClass?: pulumi.Input<string>;
+  parameterGroupName?: pulumi.Input<string>;
+  tags?: pulumi.Input<{
+    [key: string]: pulumi.Input<string>;
+  }>;
+};
+```
+Database replica requires primary DB instance to exist.
+
 ### Redis
 
 [Upstash](https://upstash.com) Redis instance.

package/dist/components/database-replica.d.ts

@@ -0,0 +1,64 @@
+import * as aws from '@pulumi/aws';
+import * as pulumi from '@pulumi/pulumi';
+export type DatabaseReplicaArgs = {
+    /**
+     * ARN of the primary DB that we want to replicate.
+     */
+    replicateSourceDb: pulumi.Input<string>;
+    /**
+     * DB subnet group name. Should be the same as primary instance.
+     * * If primary DB is instance of studion:Database, it can be accessed as
+     * `db.dbSubnetGroup.name`.
+     */
+    dbSubnetGroupName: pulumi.Input<string>;
+    /**
+     * DB security group ID. Should be the same as primary instance.
+     * If primary DB is instance of studion:Database, it can be accessed as
+     * `db.dbSecurityGroup.id`.
+     */
+    dbSecurityGroupId: pulumi.Input<string>;
+    /**
+     * IAM Monitoring role. Should be the same as primary instance.
+     */
+    monitoringRole?: aws.iam.Role;
+    /**
+     * Specifies if the RDS instance is multi-AZ. Defaults to false.
+     */
+    multiAz?: pulumi.Input<boolean>;
+    /**
+     * Specifies whether any database modifications are applied immediately,
+     * or during the next maintenance window. Default is false.
+     */
+    applyImmediately?: pulumi.Input<boolean>;
+    /**
+     * The allocated storage in gibibytes. Defaults to 20GB.
+     */
+    allocatedStorage?: pulumi.Input<number>;
+    /**
+     * The upper limit to which Amazon RDS can automatically scale
+     * the storage of the DB instance. Defaults to 100GB.
+     */
+    maxAllocatedStorage?: pulumi.Input<number>;
+    /**
+     * The instance type of the RDS instance. Defaults to 'db.t4g.micro'.
+     */
+    instanceClass?: pulumi.Input<string>;
+    /**
+     * The name of custom aws.rds.ParameterGroup. Setting this param will apply custom
+     * DB parameters to this instance.
+     */
+    parameterGroupName?: pulumi.Input<string>;
+    /**
+     * A map of tags to assign to the resource.
+     */
+    tags?: pulumi.Input<{
+        [key: string]: pulumi.Input<string>;
+    }>;
+};
+export declare class DatabaseReplica extends pulumi.ComponentResource {
+    name: string;
+    instance: aws.rds.Instance;
+    monitoringRole?: aws.iam.Role;
+    constructor(name: string, args: DatabaseReplicaArgs, opts?: pulumi.ComponentResourceOptions);
+    private createDatabaseInstance;
+}

package/dist/components/database-replica.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseReplica = void 0;
+const aws = require("@pulumi/aws");
+const pulumi = require("@pulumi/pulumi");
+const constants_1 = require("../constants");
+const defaults = {
+    multiAz: false,
+    applyImmediately: false,
+    skipFinalSnapshot: false,
+    allocatedStorage: 20,
+    maxAllocatedStorage: 100,
+    instanceClass: 'db.t4g.micro',
+    enableMonitoring: false,
+};
+class DatabaseReplica extends pulumi.ComponentResource {
+    constructor(name, args, opts = {}) {
+        super('studion:DatabaseReplica', name, {}, opts);
+        this.name = name;
+        const argsWithDefaults = Object.assign({}, defaults, args);
+        this.monitoringRole = argsWithDefaults.monitoringRole;
+        this.instance = this.createDatabaseInstance(args);
+        this.registerOutputs();
+    }
+    createDatabaseInstance(args) {
+        const argsWithDefaults = Object.assign({}, defaults, args);
+        const stack = pulumi.getStack();
+        const monitoringOptions = argsWithDefaults.enableMonitoring && this.monitoringRole
+            ? {
+                monitoringInterval: 60,
+                monitoringRoleArn: this.monitoringRole.arn,
+                performanceInsightsEnabled: true,
+                performanceInsightsRetentionPeriod: 7,
+            }
+            : {};
+        const instance = new aws.rds.Instance(`${this.name}-rds`, Object.assign(Object.assign({ identifierPrefix: `${this.name}-`, engine: 'postgres', engineVersion: '15.5', allocatedStorage: argsWithDefaults.allocatedStorage, maxAllocatedStorage: argsWithDefaults.maxAllocatedStorage, instanceClass: argsWithDefaults.instanceClass, dbSubnetGroupName: argsWithDefaults.dbSubnetGroupName, vpcSecurityGroupIds: [argsWithDefaults.dbSecurityGroupId], storageEncrypted: true, multiAz: argsWithDefaults.multiAz, publiclyAccessible: false, applyImmediately: argsWithDefaults.applyImmediately, autoMinorVersionUpgrade: true, maintenanceWindow: 'Mon:07:00-Mon:07:30', replicateSourceDb: argsWithDefaults.replicateSourceDb, parameterGroupName: argsWithDefaults.parameterGroupName }, monitoringOptions), { tags: Object.assign(Object.assign({}, constants_1.commonTags), argsWithDefaults.tags) }), { parent: this });
+        return instance;
+    }
+}
+exports.DatabaseReplica = DatabaseReplica;

package/dist/components/database.d.ts

@@ -52,6 +52,11 @@ export type DatabaseArgs = {
      * Set this to true to enable database monitoring. Defaults to false.
      */
     enableMonitoring?: pulumi.Input<boolean>;
+    /**
+     * The name of custom aws.rds.ParameterGroup. Setting this param will apply custom
+     * DB parameters to this instance.
+     */
+    parameterGroupName?: pulumi.Input<string>;
     /**
      * A map of tags to assign to the resource.
      */

package/dist/components/database.js

@@ -96,7 +96,7 @@ class Database extends pulumi.ComponentResource {
                 performanceInsightsRetentionPeriod: 7,
             }
             : {};
-        const instance = new aws.rds.Instance(`${this.name}-rds`, Object.assign(Object.assign({ identifierPrefix: `${this.name}-`, engine: 'postgres', engineVersion: '15.3', allocatedStorage: argsWithDefaults.allocatedStorage, maxAllocatedStorage: argsWithDefaults.maxAllocatedStorage, instanceClass: argsWithDefaults.instanceClass, dbName: argsWithDefaults.dbName, username: argsWithDefaults.username, password: this.password.value, dbSubnetGroupName: this.dbSubnetGroup.name, vpcSecurityGroupIds: [this.dbSecurityGroup.id], storageEncrypted: true, kmsKeyId: this.kms.arn, multiAz: argsWithDefaults.multiAz, publiclyAccessible: false, skipFinalSnapshot: argsWithDefaults.skipFinalSnapshot, applyImmediately: argsWithDefaults.applyImmediately, autoMinorVersionUpgrade: true, maintenanceWindow: 'Mon:07:00-Mon:07:30', finalSnapshotIdentifier: `${this.name}-final-snapshot-${stack}`, backupWindow: '06:00-06:30', backupRetentionPeriod: 14 }, monitoringOptions), { tags: Object.assign(Object.assign({}, constants_1.commonTags), argsWithDefaults.tags) }), { parent: this, dependsOn: [this.password] });
+        const instance = new aws.rds.Instance(`${this.name}-rds`, Object.assign(Object.assign({ identifierPrefix: `${this.name}-`, engine: 'postgres', engineVersion: '15.5', allocatedStorage: argsWithDefaults.allocatedStorage, maxAllocatedStorage: argsWithDefaults.maxAllocatedStorage, instanceClass: argsWithDefaults.instanceClass, dbName: argsWithDefaults.dbName, username: argsWithDefaults.username, password: this.password.value, dbSubnetGroupName: this.dbSubnetGroup.name, vpcSecurityGroupIds: [this.dbSecurityGroup.id], storageEncrypted: true, kmsKeyId: this.kms.arn, multiAz: argsWithDefaults.multiAz, publiclyAccessible: false, skipFinalSnapshot: argsWithDefaults.skipFinalSnapshot, applyImmediately: argsWithDefaults.applyImmediately, autoMinorVersionUpgrade: true, maintenanceWindow: 'Mon:07:00-Mon:07:30', finalSnapshotIdentifier: `${this.name}-final-snapshot-${stack}`, backupWindow: '06:00-06:30', backupRetentionPeriod: 14, parameterGroupName: argsWithDefaults.parameterGroupName }, monitoringOptions), { tags: Object.assign(Object.assign({}, constants_1.commonTags), argsWithDefaults.tags) }), { parent: this, dependsOn: [this.password] });
         return instance;
     }
 }

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './components/web-server';
 export * from './components/mongo';
 export * from './components/static-site';
 export * from './components/database';
+export * from './components/database-replica';
 export * from './components/redis';
 export * from './components/project';
 export * from './components/ec2-ssm-connect';

package/dist/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./components/web-server"), exports);
 __exportStar(require("./components/mongo"), exports);
 __exportStar(require("./components/static-site"), exports);
 __exportStar(require("./components/database"), exports);
+__exportStar(require("./components/database-replica"), exports);
 __exportStar(require("./components/redis"), exports);
 __exportStar(require("./components/project"), exports);
 __exportStar(require("./components/ec2-ssm-connect"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studion/infra-code-blocks",
-  "version": "0.4.4",
+  "version": "0.5.1",
   "description": "Studion common infra components",
   "keywords": [
     "infrastructure",