@mavogel/cdk-vscode-server 0.0.56 → 0.0.58

package/.jsii

@@ -4082,7 +4082,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/MV-Consulting/cdk-vscode-server.git",
-  "jsiiVersion": "5.8.20 (build bb5928c)",
+  "jsiiVersion": "5.8.21 (build 0b7c0ba)",
   "keywords": [
     "aws",
     "cdk",
@@ -4603,6 +4603,6 @@
       "symbolId": "src/vscode-server:VSCodeServerProps"
     }
   },
-  "version": "0.0.56",
-  "fingerprint": "gV9xsEiWCOrlugATByYLsKJMFqoOp5MZpNf9HViUhRM="
+  "version": "0.0.58",
+  "fingerprint": "OFfCp+yonoPLAT1b60RPzT4NT6DRDr4JaAF0VhbWfoo="
 }

package/lib/vscode-server.js

@@ -572,7 +572,7 @@ class VSCodeServer extends constructs_1.Construct {
 }
 exports.VSCodeServer = VSCodeServer;
 _a = JSII_RTTI_SYMBOL_1;
-VSCodeServer[_a] = { fqn: "@mavogel/cdk-vscode-server.VSCodeServer", version: "0.0.56" };
+VSCodeServer[_a] = { fqn: "@mavogel/cdk-vscode-server.VSCodeServer", version: "0.0.58" };
 /**
  * Tags all the resources in the construct
  */

package/mavogelcdkvscodeserver/README.md

@@ -20,6 +20,9 @@ we implement new features. Therefore make sure you use an exact version in your
 
 * [Features](#features)
 * [Usage](#usage)
+
+  * [Standard](#Standard)
+  * [Custom Domain Configuration](#custom-domain-configuration)
 * [Solution Design](#solution-design)
 * [Inspiration](#inspiration)
 
@@ -28,10 +31,15 @@ we implement new features. Therefore make sure you use an exact version in your
 * ⚡ **Quick Setup**: Spin up and configure your [vscode](https://code.visualstudio.com/) server in under 10 minutes in your AWS account
 * 📏 **Best Practice Setup**: Set up with [projen](https://projen.io/) and a [single configuration file](./.projenrc.ts) to keep your changes centralized.
 * 🤹‍♂️ **Pre-installed packages**: Besides the [vscode](https://code.visualstudio.com/) server, other tools and software packages such as `git`, `docker`, `awscli` `nodejs` and `python` are pre-installed on the EC2 instance.
+* 🌐 **Custom Domain Support**: Use your own domain name with automatic ACM certificate creation and Route53 DNS configuration, or bring your existing certificate.
 * 🏗️ **Extensibility**: Pass in properties to the construct, which start with `additional*`. They allow you to extend the configuration to your needs. There are more to come...
 
 ## Usage
 
+Actually we supported 2 modes:
+
+### Standard
+
 The following steps get you started:
 
 1. Create a new `awscdk-app` via
@@ -114,6 +122,53 @@ dev.vscodepassword64FBCA12 = foobarbaz
 
 See the [examples](./examples) folder for more inspiration.
 
+### Custom Domain Configuration
+
+You can configure your VS Code Server with a custom domain name instead of using the default CloudFront domain. The construct supports three different configuration options:
+
+#### Option 1: Auto-create Certificate with DNS Validation
+
+```go
+new VSCodeServer(this, 'vscode', {
+  domainName: 'vscode.example.com',
+  hostedZoneId: 'Z123EXAMPLE456',  // optional - will auto-discover if not provided
+  autoCreateCertificate: true,
+});
+```
+
+This will:
+
+* Create an ACM certificate in us-east-1 (required for CloudFront)
+* Validate the certificate using DNS validation
+* Create a Route53 A record pointing to the CloudFront distribution
+* Configure the CloudFront distribution with the custom domain
+
+#### Option 2: Use Existing Certificate
+
+```go
+new VSCodeServer(this, 'vscode', {
+  domainName: 'vscode.example.com',
+  hostedZoneId: 'Z123EXAMPLE456',
+  certificateArn: 'arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012',
+});
+```
+
+**Requirements:**
+
+* Certificate must be in us-east-1 region
+* Certificate must be validated and ready to use
+* Certificate must include the domain name
+
+#### Option 3: Default (No Custom Domain)
+
+```go
+new VSCodeServer(this, 'vscode', {
+  // No domain configuration - uses CloudFront default domain
+});
+```
+
+For complete examples, see [examples/custom-domain/main.ts](./examples/custom-domain/main.ts).
+
 1. Then open the domain name in your favorite browser and you'd see the following login screen:
    ![vscode-server-ui-login](docs/img/vscode-server-ui-login-min.png)
 2. After entering the password, you are logged into VSCode and can start coding :tada:

package/mavogelcdkvscodeserver/VSCodeServerProps.go

@@ -18,6 +18,16 @@ type VSCodeServerProps struct {
 	//
 	// Experimental.
 	AdditionalTags *map[string]*string `field:"optional" json:"additionalTags" yaml:"additionalTags"`
+	// Auto-create ACM certificate with DNS validation in us-east-1 region Requires hostedZoneId to be provided for DNS validation Cannot be used together with certificateArn Certificate will automatically be created in us-east-1 as required by CloudFront.
+	// Default: false.
+	//
+	// Experimental.
+	AutoCreateCertificate *bool `field:"optional" json:"autoCreateCertificate" yaml:"autoCreateCertificate"`
+	// ARN of existing ACM certificate for the domain Certificate must be in us-east-1 region for CloudFront Cannot be used together with autoCreateCertificate.
+	// Default: - auto-create certificate if autoCreateCertificate is true.
+	//
+	// Experimental.
+	CertificateArn *string `field:"optional" json:"certificateArn" yaml:"certificateArn"`
 	// Base path for the application to be added to Nginx sites-available list.
 	// Default: - app.
 	//
@@ -28,11 +38,21 @@ type VSCodeServerProps struct {
 	//
 	// Experimental.
 	DevServerPort *float64 `field:"optional" json:"devServerPort" yaml:"devServerPort"`
+	// Custom domain name for the VS Code server When provided, creates a CloudFront distribution with this domain name and sets up Route53 A record pointing to the distribution.
+	// Default: - uses CloudFront default domain.
+	//
+	// Experimental.
+	DomainName *string `field:"optional" json:"domainName" yaml:"domainName"`
 	// Folder to open in VS Code server.
 	// Default: - /Workshop.
 	//
 	// Experimental.
 	HomeFolder *string `field:"optional" json:"homeFolder" yaml:"homeFolder"`
+	// Route53 hosted zone ID for the domain Required when using autoCreateCertificate If not provided, will attempt to lookup hosted zone from domain name.
+	// Default: - auto-discover from domain name.
+	//
+	// Experimental.
+	HostedZoneId *string `field:"optional" json:"hostedZoneId" yaml:"hostedZoneId"`
 	// VSCode Server EC2 instance class.
 	// Default: - m7g.
 	//

package/mavogelcdkvscodeserver/go.mod

@@ -3,10 +3,10 @@ module github.com/MV-Consulting/cdk-vscode-server/mavogelcdkvscodeserver
 go 1.23
 
 require (
-	github.com/aws/jsii-runtime-go v1.114.1
+	github.com/aws/jsii-runtime-go v1.115.0
 	github.com/MV-Consulting/mvc-projen/mavogelmvcprojen v0.0.7
 	github.com/aws/aws-cdk-go/awscdk/v2 v2.190.0
-	github.com/cdklabs/cdk-nag-go/cdknag/v2 v2.37.38
+	github.com/cdklabs/cdk-nag-go/cdknag/v2 v2.37.45
 	github.com/aws/constructs-go/constructs/v10 v10.4.2
 	github.com/projen/projen-go/projen v0.91.8 // indirect
 	github.com/cdklabs/awscdk-asset-awscli-go/awscliv1/v2 v2.2.242 // indirect

package/mavogelcdkvscodeserver/jsii/jsii.go

@@ -15,7 +15,7 @@ import (
 	mavogelmvcprojen "github.com/MV-Consulting/mvc-projen/mavogelmvcprojen/jsii"
 )
 
-//go:embed mavogel-cdk-vscode-server-0.0.55.tgz
+//go:embed mavogel-cdk-vscode-server-0.0.57.tgz
 var tarball []byte
 
 // Initialize loads the necessary packages in the @jsii/kernel to support the enclosing module.
@@ -28,5 +28,5 @@ func Initialize() {
 	constructs.Initialize()
 
 	// Load this library into the kernel
-	_jsii_.Load("@mavogel/cdk-vscode-server", "0.0.55", tarball)
+	_jsii_.Load("@mavogel/cdk-vscode-server", "0.0.57", tarball)
 }

package/mavogelcdkvscodeserver/version

@@ -1 +1 @@
-0.0.55
+0.0.57

package/package.json

@@ -104,7 +104,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.56",
+  "version": "0.0.58",
   "jest": {
     "coverageProvider": "v8",
     "testMatch": [