feat!: intmdb 1023 private endpoint service (#133)

Author: Adelmar92

API.md

@@ -0,0 +1,52 @@
+import * as cdk from 'aws-cdk-lib';
+import { Construct } from 'constructs';
+import { CfnPrivateEndpoint } from 'awscdk-resources-mongodbatlas';
+
+interface AtlasStackProps {
+  readonly projId: string;
+  readonly profile: string;
+  readonly region: string;
+  readonly vpcId: string;
+  readonly subnetId: string;
+}
+
+export class CdkTestingStack extends cdk.Stack {
+  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
+    super(scope, id, props);
+
+    const atlasProps = this.getContextProps();
+
+    new CfnPrivateEndpoint (this, "privateEndpoint", {
+      projectId: atlasProps.projId,
+      profile:  atlasProps.profile,
+      region: atlasProps.region,
+      privateEndpoints: [
+          {
+            vpcId: atlasProps.vpcId,
+            subnetIds: [atlasProps.subnetId]
+          }
+      ],
+    });
+  }
+
+  getContextProps(): AtlasStackProps {
+    const projId = this.node.tryGetContext('projId');
+    if (!projId){
+      throw "No context value specified for orgId. Please specify via the cdk context."
+    }
+    
+    const profile = this.node.tryGetContext('profile') ?? 'default';
+    const region = this.node.tryGetContext('region');
+    const vpcId = this.node.tryGetContext('vpcId');
+    const subnetId = this.node.tryGetContext('comment');
+
+
+    return {
+      projId,
+      profile,
+      region,
+      vpcId,
+      subnetId,
+    }
+  }
+}

examples/l1-resources/private-endpoint-v1-deprecated.ts

@@ -1,6 +1,8 @@
+import { CfnPrivateEndpointAws } from './../../src/l1-resources/private-endpoint-aws/index';
 import * as cdk from 'aws-cdk-lib';
+import * as ec2 from 'aws-cdk-lib/aws-ec2';
 import { Construct } from 'constructs';
-import { CfnPrivateEndpoint } from 'awscdk-resources-mongodbatlas';
+import { CfnPrivateEndpointService, CfnPrivateEndpointServicePropsCloudProvider } from '../../src/l1-resources/private-endpoint-service';
 
 interface AtlasStackProps {
   readonly projId: string;
@@ -10,23 +12,36 @@ interface AtlasStackProps {
   readonly subnetId: string;
 }
 
-export class CdkTestingStack extends cdk.Stack {
+export class CdkPrivateEndpoint extends cdk.Stack {
   constructor(scope: Construct, id: string, props?: cdk.StackProps) {
     super(scope, id, props);
 
     const atlasProps = this.getContextProps();
 
-    const myPrivateEndpoint = new CfnPrivateEndpoint (this, "privateEndpoint", {
+    const atlasService = new CfnPrivateEndpointService(this, "AtlasPrivateEndpointService", {
       projectId: atlasProps.projId,
-      profile:  atlasProps.profile,
+      profile: atlasProps.profile,
       region: atlasProps.region,
-      privateEndpoints: [
-          {
-            vpcId: atlasProps.vpcId,
-            subnetIds: [atlasProps.subnetId]
-          }
-      ],
+      cloudProvider: CfnPrivateEndpointServicePropsCloudProvider.AWS
     });
+
+    const awsPrivateEndpoint = new ec2.CfnVPCEndpoint(this, 'AWSPrivateEndpoint', {
+      serviceName: atlasService.attrEndpointServiceName,
+      subnetIds: [atlasProps.subnetId],
+      vpcEndpointType: 'Interface',
+      vpcId: atlasProps.vpcId,
+    });
+
+    awsPrivateEndpoint.addDependency(atlasService)
+    
+    const myPrivateEndpoint = new CfnPrivateEndpointAws (this, "AtlasPrivateEndpoint", {
+      projectId: atlasProps.projId,
+      profile: atlasProps.profile,
+      endpointServiceId: atlasService.attrId,
+      id : awsPrivateEndpoint.ref,
+    });
+
+    myPrivateEndpoint.addDependency(myPrivateEndpoint)
   }
 
   getContextProps(): AtlasStackProps {

examples/l1-resources/private-endpoint.ts

@@ -18,7 +18,7 @@ export class CdkTestingStack extends cdk.Stack {
     super(scope, id, props);
 
     const atlasProps = this.getContextProps();
-    const atlasBasicPrivateEndpointasBasic = new AtlasBasicPrivateEndpoint(this, 'AtlasBasic', {
+    new AtlasBasicPrivateEndpoint(this, 'AtlasBasic', {
       atlasBasicProps: {
         clusterProps: {
         name: atlasProps.clusterName,  
@@ -53,13 +53,8 @@ export class CdkTestingStack extends cdk.Stack {
         }
       },
       privateEndpointProps: {
-        privateEndpoints: [
-          {
-            vpcId: atlasProps.vpcId,
-            subnetIds: [atlasProps.subnetId],
-          }
-  
-        ]
+        awsVpcId: atlasProps.vpcId,
+        awsSubnetId: atlasProps.subnetId,
       },
       profile: atlasProps.profile,
 

examples/l3-resources/atlas-basic-private-endpoint.ts

@@ -217,6 +217,17 @@ export {
   PrivateEndpoint,
 } from "./l1-resources/private-endpoint";
 
+export {
+  CfnPrivateEndpointAwsProps,
+  CfnPrivateEndpointAws,
+} from "./l1-resources/private-endpoint-aws";
+
+export {
+  CfnPrivateEndpointService,
+  CfnPrivateEndpointServiceProps,
+  CfnPrivateEndpointServicePropsCloudProvider,
+} from "./l1-resources/private-endpoint-service";
+
 export {
   CfnServerlessPrivateEndpointProps,
   CfnServerlessPrivateEndpoint,

src/index.ts

@@ -0,0 +1,65 @@
+# private-endpoint
+
+The official [MongoDB Atlas](https://www.mongodb.com/) AWS CDK resource for Node.js.
+
+> AWS CDK [L1 construct] and data structures for the [AWS CloudFormation Registry] type `MongoDB::Atlas::PrivateEndpointAWS` v1.0.0.
+
+[l1 construct]: https://docs.aws.amazon.com/cdk/latest/guide/constructs.html
+[aws cloudformation registry]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html
+
+## Description
+
+Creates one private endpoint for the specified cloud service provider. This cloud service provider manages the private endpoint service, which in turn manages the private endpoints for the project. To use this resource, the requesting API Key must have the Project Owner role. To learn more about considerations, limitations, and prerequisites, see the MongoDB documentation for setting up a private endpoint.
+
+## MongoDB Atlas API Docs
+
+For more information about the API refer to: [API Endpoints](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Private-Endpoint-Services)
+
+## Usage
+
+In order to use this library, you will need to activate this AWS CloudFormation Registry type in your account. You can do this via the AWS Management Console or using the [AWS CLI](https://aws.amazon.com/cli/) using the following command:
+
+```sh
+aws cloudformation activate-type \
+  --type-name MongoDB::Atlas::PrivateEndpointAWS \
+  --publisher-id bb989456c78c398a858fef18f2ca1bfc1fbba082 \
+  --type RESOURCE \
+  --execution-role-arn ROLE-ARN
+```
+
+Alternatively:
+
+```sh
+aws cloudformation activate-type \
+  --public-type-arn arn:aws:cloudformation:us-east-1::type/resource/bb989456c78c398a858fef18f2ca1bfc1fbba082/MongoDB-Atlas-PrivateEndpointAWS \
+  --execution-role-arn ROLE-ARN
+```
+
+You can find more information about activating this type in the [AWS CloudFormation documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-public.html).
+
+## Example: [private-endpoint.ts](../../../examples/l1-resources/private-endpoint.ts)
+
+```ts
+import { CfnPrivateEndpoint } from 'awscdk-resources-mongodbatlas'
+
+const myPrivateEndpoint = new CfnPrivateEndpointAws(this, 'privateEndpoint', {
+  projectId: atlasProject,
+  endpointServiceId: 'endpointServiceId' /*Id of the PrivateEndpointService*/,
+  profile: 'default',
+  id: ''
+})
+```
+
+## Feedback
+
+This library is auto-generated and published to all supported programming languages by the [cdklabs/cdk-cloudformation] project based on the API schema published for `MongoDB::Atlas::PrivateEndpointAWS`.
+
+- Issues related to this generated library should be [reported here](https://github.com/cdklabs/cdk-cloudformation/issues/new?title=Issue+with+%40cdk-cloudformation%2Fmongodb-atlas-privateendpoint+v1.0.0).
+- Issues related to `MongoDB::Atlas::PrivateEndpointAWS` should be reported to the [publisher](https://github.com/mongodb/mongodbatlas-cloudformation-resources/issues).
+- Feature requests should be [reported here](https://feedback.mongodb.com/forums/924145-atlas?category_id=392596)
+
+[cdklabs/cdk-cloudformation]: https://github.com/cdklabs/cdk-cloudformation
+
+## License
+
+Distributed under the Apache-2.0 License.

src/l1-resources/private-endpoint-aws/README.md

@@ -0,0 +1,125 @@
+// Generated by cdk-import
+import * as cdk from "aws-cdk-lib";
+import * as constructs from "constructs";
+
+/**
+ * Creates one private endpoint for the specified cloud service provider. At this current version only AWS is supported
+ *
+ * @schema CfnPrivateEndpointAwsProps
+ */
+export interface CfnPrivateEndpointAwsProps {
+  /**
+   * The profile is defined in AWS Secret manager. See [Secret Manager Profile setup (../../../examples/profile-secret.yaml)
+   *
+   * @schema CfnPrivateEndpointAwsProps#Profile
+   */
+  readonly profile?: string;
+
+  /**
+   * Unique 24-hexadecimal digit string that identifies your project.
+   *
+   * @schema CfnPrivateEndpointAwsProps#ProjectId
+   */
+  readonly projectId: string;
+
+  /**
+   * Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to create a private endpoint.
+   *
+   * @schema CfnPrivateEndpointAwsProps#EndpointServiceId
+   */
+  readonly endpointServiceId: string;
+
+  /**
+   * Unique string that identifies the private endpoint. for AWS is the VPC endpoint ID, example: vpce-xxxxxxxx
+   *
+   * @schema CfnPrivateEndpointAwsProps#Id
+   */
+  readonly id?: string;
+
+  /**
+   * If this proper is set to TRUE, the cloud formation resource will return success Only if the private connection is Succeeded
+   *
+   * @schema CfnPrivateEndpointAwsProps#EnforceConnectionSuccess
+   */
+  readonly enforceConnectionSuccess?: boolean;
+
+  /**
+   * State of the Amazon Web Service PrivateLink connection when MongoDB Cloud received this request.
+   *
+   * @schema CfnPrivateEndpointAwsProps#ConnectionStatus
+   */
+  readonly connectionStatus?: string;
+
+  /**
+   * Error message returned when requesting private connection resource. The resource returns null if the request succeeded.
+   *
+   * @schema CfnPrivateEndpointAwsProps#ErrorMessage
+   */
+  readonly errorMessage?: string;
+}
+
+/**
+ * Converts an object of type 'CfnPrivateEndpointAwsProps' to JSON representation.
+ */
+/* eslint-disable max-len, quote-props */
+export function toJson_CfnPrivateEndpointAwsProps(
+  obj: CfnPrivateEndpointAwsProps | undefined
+): Record<string, any> | undefined {
+  if (obj === undefined) {
+    return undefined;
+  }
+  const result = {
+    Profile: obj.profile,
+    ProjectId: obj.projectId,
+    EndpointServiceId: obj.endpointServiceId,
+    Id: obj.id,
+    EnforceConnectionSuccess: obj.enforceConnectionSuccess,
+    ConnectionStatus: obj.connectionStatus,
+    ErrorMessage: obj.errorMessage,
+  };
+  // filter undefined values
+  return Object.entries(result).reduce(
+    (r, i) => (i[1] === undefined ? r : { ...r, [i[0]]: i[1] }),
+    {}
+  );
+}
+/* eslint-enable max-len, quote-props */
+
+/**
+ * A CloudFormation `MongoDB::Atlas::PrivateEndpointAWS`
+ *
+ * @cloudformationResource MongoDB::Atlas::PrivateEndpointAWS
+ * @stability external
+ */
+export class CfnPrivateEndpointAws extends cdk.CfnResource {
+  /**
+   * The CloudFormation resource type name for this resource class.
+   */
+  public static readonly CFN_RESOURCE_TYPE_NAME =
+    "MongoDB::Atlas::PrivateEndpointAWS";
+
+  /**
+   * Resource props.
+   */
+  public readonly props: CfnPrivateEndpointAwsProps;
+
+  /**
+   * Create a new `MongoDB::Atlas::PrivateEndpointAWS`.
+   *
+   * @param scope - scope in which this resource is defined
+   * @param id    - scoped id of the resource
+   * @param props - resource properties
+   */
+  constructor(
+    scope: constructs.Construct,
+    id: string,
+    props: CfnPrivateEndpointAwsProps
+  ) {
+    super(scope, id, {
+      type: CfnPrivateEndpointAws.CFN_RESOURCE_TYPE_NAME,
+      properties: toJson_CfnPrivateEndpointAwsProps(props)!,
+    });
+
+    this.props = props;
+  }
+}

src/l1-resources/private-endpoint-aws/index.ts

@@ -0,0 +1,20 @@
+import * as cdk from "aws-cdk-lib";
+import { CfnPrivateEndpointAws } from "./index";
+
+const app = new cdk.App();
+const stack = new cdk.Stack(app, "atlas-privateEndpoint", {
+  env: {
+    region: process.env.CDK_DEFAULT_REGION,
+    account: process.env.CDK_DEFAULT_ACCOUNT,
+  },
+});
+
+const atlasProject = "6536c77b1c203c46c251ff0b";
+
+new CfnPrivateEndpointAws(stack, "AtlasPrivateEndpoint", {
+  projectId: atlasProject,
+  endpointServiceId: "6536c7814104246bc7d0e940",
+  profile: "default",
+  id: "vpce-097276cb6f9eab2f5",
+  enforceConnectionSuccess: false,
+});