@mavogel/cdk-vscode-server 0.0.64 → 0.0.65

package/CLAUDE.md

@@ -173,6 +173,10 @@ aws ssm get-parameters --names \
 - `idleCheckIntervalMinutes` - How often to check (default: 5)
 - `skipStatusChecks` - Skip EC2 status checks before stopping (for testing only)
 
+**Custom Installation**:
+- `customInstallSteps` - Array of custom shell commands that run after standard installation
+- `repoUrl` - Git repository to clone into home folder during setup
+
 **Extensions**:
 - `additionalInstanceRolePolicies`, `additionalTags`
 
@@ -182,6 +186,7 @@ aws ssm get-parameters --names \
 - All public APIs must be JSII-compatible (no TS-specific types)
 - Bundled dependencies (like `node-html-parser`) must be in `.projenrc.ts` `bundledDeps`
 - Lambda functions use esbuild bundling configured via Projen (auto-discovered in `src/**/*.lambda.ts`)
+- **@example JSDoc blocks must NOT use code fences** (```) - JSII will fail with "must be code only, no code block fences allowed"
 
 ## CDK-nag Integration
 
@@ -239,11 +244,50 @@ Projen automatically discovers Lambda functions matching `src/**/*.lambda.ts` pa
 3. Run `npx projen` - auto-discovers and creates bundle task
 4. Import in construct: `import { MyFeatureFunction } from './my-feature/my-feature-function'`
 
+### Adding Custom Installation Steps
+
+Custom steps are appended to SSM document `mainSteps` array in `createSSMDocument()`:
+
+1. **Define interface** (if needed) in `src/vscode-server.ts`:
+   ```typescript
+   export interface CustomInstallStep {
+     readonly name: string;
+     readonly commands: string[];
+   }
+   ```
+
+2. **Add prop** to `VSCodeServerProps` with JSDoc documentation (no code fences!)
+
+3. **Pass to Installer** in both Ubuntu and Amazon Linux paths:
+   ```typescript
+   installer = Installer.ubuntu({
+     // ... other options
+     customInstallSteps: customInstallSteps,
+   })._bind(this);
+   ```
+
+4. **Update `createSSMDocument()`** in `src/installer/installer.ts` to accept and use custom steps:
+   ```typescript
+   ...(customInstallSteps?.map((step) => ({
+     action: 'aws:runShellScript' as const,
+     name: step.name,
+     inputs: {
+       runCommand: step.commands,
+     },
+   })) ?? []),
+   ```
+
+5. **Write unit tests** in `test/vscode-server.test.ts` covering normal usage, without steps, and empty array
+
+6. **Update documentation** in README.md with practical examples and add to `examples/` directory
+
 ### Modifying VSCodeServer Props
 
 1. Edit `src/vscode-server.ts` - update `VSCodeServerProps` interface
-2. Run `npx projen build` - regenerates JSII artifacts + API docs
-3. Update README.md with usage examples
+2. If adding new types/interfaces, export them from `src/vscode-server.ts`
+3. Run `npx projen build` - regenerates JSII artifacts + API docs
+4. Update README.md with usage examples and feature section
+5. Add example usage in `examples/` directory
 
 ### Testing Changes
 

package/README.md

@@ -24,6 +24,7 @@ we implement new features. Therefore make sure you use an exact version in your
   - [Pre-populate with Git Repository](#pre-populate-with-git-repository)
   - [Custom Domain Configuration](#custom-domain-configuration)
   - [Auto-Stop Configuration](#auto-stop-configuration)
+  - [Custom Installation Steps](#custom-installation-steps)
 - [Solution Design](#solution-design)
 - [Inspiration](#inspiration)
 
@@ -34,6 +35,7 @@ we implement new features. Therefore make sure you use an exact version in your
 - 🤹‍♂️ **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.
 - 💰 **Auto-Stop**: Automatically stop EC2 instances after inactivity with Elastic IP retention - save up to 75% on costs for development environments.
+- 🔧 **Custom Install Steps**: Extend the standard installation with your own shell commands to install workshop-specific tools, configure environments, or run setup scripts.
 - 🏗️ **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
@@ -261,6 +263,67 @@ Run integration tests with:
 npm run integ-test
 ```
 
+### Custom Installation Steps
+
+Extend the standard VS Code Server installation with your own custom shell commands - perfect for installing workshop-specific tools, configuring development environments, or running setup scripts:
+
+```ts
+new VSCodeServer(this, 'vscode', {
+  // Add custom installation steps that run after standard setup
+  customInstallSteps: [
+    {
+      name: 'InstallWorkshopTools',
+      commands: [
+        '#!/bin/bash',
+        'echo "Installing workshop-specific tools"',
+
+        // Install additional software
+        'curl -fsSL https://get.docker.com | sh',
+        'usermod -aG docker ubuntu',
+
+        // Configure environment
+        'echo "export WORKSHOP_ENV=production" >> /home/ubuntu/.bashrc',
+      ],
+    },
+    {
+      name: 'CloneStarterCode',
+      commands: [
+        '#!/bin/bash',
+        'cd /home/ubuntu',
+        'git clone https://github.com/my-org/workshop-starter.git',
+        'chown -R ubuntu:ubuntu workshop-starter',
+      ],
+    },
+  ],
+});
+```
+
+**Key Features:**
+- **Execute After Standard Setup**: Custom steps run after VS Code Server installation completes
+- **Multiple Steps**: Add as many installation steps as needed, executed in order
+- **Full Shell Access**: Run any shell commands with root privileges
+- **Workshop-Friendly**: Pre-install tools, configure environments, or download starter code
+
+**Common Use Cases:**
+- Install additional development tools (Docker, kubectl, terraform)
+- Configure workshop-specific environments and credentials
+- Clone starter code repositories with specific permissions
+- Set up databases or services required for training
+- Download and prepare datasets or assets
+- Configure IDE extensions or settings
+
+**Supported Operating Systems:**
+- Ubuntu 22/24/25
+- Amazon Linux 2023
+
+**Requirements:**
+- Commands execute with root privileges during instance initialization
+- Use absolute paths or ensure proper working directory context
+- Consider idempotency if instance might be restarted
+- Commands run synchronously in the order specified
+
+For complete examples, see [examples/custom-install-steps/main.ts](./examples/custom-install-steps/main.ts).
+
 ## Solution Design
 
 <details>

package/examples/custom/main.ts

@@ -17,7 +17,7 @@ export class MyStack extends Stack {
             instanceVolumeSize: 8,
             instanceClass: ec2.InstanceClass.M7G,
             instanceSize: ec2.InstanceSize.LARGE,
-            instanceOperatingSystem: LinuxFlavorType.UBUNTU_24,
+            instanceOperatingSystem: LinuxFlavorType.UBUNTU_24, // Supports UBUNTU_22, UBUNTU_24, UBUNTU_25, AMAZON_LINUX_2023
             instanceCpuArchitecture: LinuxArchitectureType.ARM,
 
             // 👇🏽 or if you want to give the InstanceRole more permissions
@@ -31,7 +31,29 @@ export class MyStack extends Stack {
                         `arn:aws:codebuild:*:${Stack.of(this).account}:*/*`,
                     ],
                 }),
-            ]
+            ],
+
+            // 👇🏽 Add custom installation steps to extend the standard setup
+            customInstallSteps: [
+                {
+                    name: 'InstallCodeBuildTools',
+                    commands: [
+                        '#!/bin/bash',
+                        'echo "Installing CodeBuild-related tools..."',
+                        // Install AWS CodeBuild local agent for testing
+                        'docker pull public.ecr.aws/codebuild/local-builds:latest',
+                        // Create helper script
+                        'cat > /usr/local/bin/codebuild-local << EOF',
+                        '#!/bin/bash',
+                        'docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock \\',
+                        '  -e "IMAGE_NAME=public.ecr.aws/codebuild/local-builds:latest" \\',
+                        '  public.ecr.aws/codebuild/local-builds:latest',
+                        'EOF',
+                        'chmod +x /usr/local/bin/codebuild-local',
+                        'echo "CodeBuild tools installed successfully"',
+                    ],
+                },
+            ],
 
             // and more... 💡
         });

package/examples/custom-install-steps/main.ts

@@ -0,0 +1,201 @@
+import { App, Stack, StackProps } from 'aws-cdk-lib';
+import * as ec2 from 'aws-cdk-lib/aws-ec2';
+import { Construct } from 'constructs';
+import {
+  CustomInstallStep,
+  LinuxArchitectureType,
+  LinuxFlavorType,
+  VSCodeServer,
+} from '../../src/index';
+
+/**
+ * Example: VS Code Server with Custom Installation Steps
+ *
+ * This example demonstrates how to extend the standard VS Code Server installation
+ * with custom shell commands. Perfect for:
+ * - Installing workshop-specific tools
+ * - Configuring development environments
+ * - Running setup scripts
+ * - Preparing datasets or assets
+ * - Setting up databases or services
+ *
+ * All custom steps execute with root privileges after the standard installation completes.
+ */
+export class CustomInstallStepsExampleStack extends Stack {
+  constructor(scope: Construct, id: string, props: StackProps = {}) {
+    super(scope, id, props);
+
+    // Define custom installation steps
+    const customSteps: CustomInstallStep[] = [
+      // Step 1: Install additional development tools
+      {
+        name: 'InstallDevelopmentTools',
+        commands: [
+          '#!/bin/bash',
+          'set -e', // Exit on error
+          'echo "Installing development tools..."',
+
+          // Install Docker (if not already installed)
+          'if ! command -v docker &> /dev/null; then',
+          '  curl -fsSL https://get.docker.com | sh',
+          '  usermod -aG docker ubuntu',
+          '  systemctl enable docker',
+          '  systemctl start docker',
+          'fi',
+
+          // Install kubectl
+          'curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl"',
+          'install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl',
+          'rm kubectl',
+
+          // Install terraform
+          'wget -O- https://apt.releases.hashicorp.com/gpg | gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg',
+          'echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | tee /etc/apt/sources.list.d/hashicorp.list',
+          'apt-get update && apt-get install -y terraform',
+
+          'echo "Development tools installed successfully"',
+        ],
+      },
+
+      // Step 2: Configure workshop environment
+      {
+        name: 'ConfigureWorkshopEnvironment',
+        commands: [
+          '#!/bin/bash',
+          'set -e',
+          'echo "Configuring workshop environment..."',
+
+          // Set environment variables
+          'cat >> /home/ubuntu/.bashrc << EOF',
+          '',
+          '# Workshop environment variables',
+          'export WORKSHOP_NAME="AWS CDK Workshop"',
+          'export WORKSHOP_VERSION="2.0"',
+          'export AWS_REGION="${AWS::Region}"',
+          'export AWS_ACCOUNT_ID="${AWS::AccountId}"',
+          '',
+          '# Custom aliases',
+          'alias k="kubectl"',
+          'alias tf="terraform"',
+          'alias ll="ls -la"',
+          'EOF',
+
+          // Create workshop directories
+          'mkdir -p /home/ubuntu/workshop',
+          'mkdir -p /home/ubuntu/workshop/code',
+          'mkdir -p /home/ubuntu/workshop/data',
+
+          // Set proper ownership
+          'chown -R ubuntu:ubuntu /home/ubuntu/workshop',
+          'chown ubuntu:ubuntu /home/ubuntu/.bashrc',
+
+          'echo "Workshop environment configured successfully"',
+        ],
+      },
+
+      // Step 3: Clone and prepare workshop starter code
+      {
+        name: 'PrepareWorkshopCode',
+        commands: [
+          '#!/bin/bash',
+          'set -e',
+          'echo "Preparing workshop starter code..."',
+
+          // Clone workshop repository
+          'cd /home/ubuntu/workshop/code',
+          'git clone https://github.com/aws-samples/aws-cdk-examples.git',
+
+          // Download sample datasets
+          'cd /home/ubuntu/workshop/data',
+          'curl -o sample-data.json https://raw.githubusercontent.com/aws-samples/aws-cdk-examples/main/package.json',
+
+          // Create a README for participants
+          'cat > /home/ubuntu/workshop/README.md << EOF',
+          '# Welcome to the AWS CDK Workshop!',
+          '',
+          '## Getting Started',
+          '',
+          '1. Navigate to the code directory: `cd ~/workshop/code`',
+          '2. Explore the examples: `ls -la aws-cdk-examples`',
+          '3. Run your first CDK app',
+          '',
+          '## Resources',
+          '',
+          '- AWS CDK Documentation: https://docs.aws.amazon.com/cdk',
+          '- Workshop Guide: [TBD]',
+          '',
+          '## Installed Tools',
+          '',
+          '- Node.js $(node --version)',
+          '- Python $(python3 --version)',
+          '- Docker $(docker --version)',
+          '- kubectl $(kubectl version --client --short 2>/dev/null || echo "installed")',
+          '- Terraform $(terraform version | head -n1)',
+          'EOF',
+
+          // Set ownership
+          'chown -R ubuntu:ubuntu /home/ubuntu/workshop',
+
+          'echo "Workshop code prepared successfully"',
+        ],
+      },
+
+      // Step 4: Install VS Code extensions
+      {
+        name: 'InstallVSCodeExtensions',
+        commands: [
+          '#!/bin/bash',
+          'set -e',
+          'echo "Installing VS Code extensions..."',
+
+          // Switch to ubuntu user to install extensions
+          'sudo -u ubuntu bash << EOF',
+          'export HOME=/home/ubuntu',
+
+          // Wait for code-server to be ready
+          'sleep 5',
+
+          // Install useful extensions (examples - adjust based on your needs)
+          '# Note: Extension installation via CLI requires code-server to be running',
+          '# These would typically be installed through the VS Code UI after first login',
+
+          'echo "VS Code extensions configured successfully"',
+          'EOF',
+        ],
+      },
+    ];
+
+    // Create VS Code Server with custom installation steps
+    new VSCodeServer(this, 'vscode-custom-install', {
+      // Instance configuration
+      instanceClass: ec2.InstanceClass.M7G,
+      instanceSize: ec2.InstanceSize.XLARGE,
+      instanceVolumeSize: 50, // Larger volume for additional tools
+      instanceOperatingSystem: LinuxFlavorType.UBUNTU_24, // Supports UBUNTU_22, UBUNTU_24, UBUNTU_25, AMAZON_LINUX_2023
+      instanceCpuArchitecture: LinuxArchitectureType.ARM,
+
+      // VS Code configuration
+      homeFolder: '/workshop',
+      vscodeUser: 'ubuntu',
+
+      // 🔧 Custom installation steps
+      customInstallSteps: customSteps,
+
+      // Additional configuration
+      additionalTags: {
+        Workshop: 'AWS-CDK-Workshop',
+        Environment: 'Training',
+        CustomInstallSteps: 'Enabled',
+      },
+    });
+  }
+}
+
+const env = {
+  account: process.env.CDK_DEFAULT_ACCOUNT || '123456789012',
+  region: process.env.CDK_DEFAULT_REGION || 'eu-west-1',
+};
+
+const app = new App();
+new CustomInstallStepsExampleStack(app, 'vscode-custom-install-example', { env });
+app.synth();

package/lib/idle-monitor/idle-monitor.js

@@ -83,5 +83,5 @@ class IdleMonitor extends constructs_1.Construct {
 }
 exports.IdleMonitor = IdleMonitor;
 _a = JSII_RTTI_SYMBOL_1;
-IdleMonitor[_a] = { fqn: "@mavogel/cdk-vscode-server.IdleMonitor", version: "0.0.64" };
+IdleMonitor[_a] = { fqn: "@mavogel/cdk-vscode-server.IdleMonitor", version: "0.0.65" };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaWRsZS1tb25pdG9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2lkbGUtbW9uaXRvci9pZGxlLW1vbml0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQSw2QkFBNkI7QUFDN0IsNkNBQThDO0FBRzlDLHVEQUF3RDtBQUN4RCx1RUFBd0Y7QUFDeEYsaURBQXNEO0FBQ3RELHVEQUFtRjtBQUNuRixxQ0FBMEM7QUFDMUMsMkNBQXVDO0FBcUN2Qzs7R0FFRztBQUNILE1BQWEsV0FBWSxTQUFRLHNCQUFTO0lBV3hDLFlBQVksS0FBZ0IsRUFBRSxFQUFVLEVBQUUsS0FBdUI7UUFDL0QsS0FBSyxDQUFDLEtBQUssRUFBRSxFQUFFLENBQUMsQ0FBQztRQUVqQixJQUFJLENBQUMsUUFBUSxHQUFHLElBQUkscUJBQWMsQ0FBQyxJQUFJLEVBQUUsVUFBVSxFQUFFO1lBQ25ELE9BQU8sRUFBRSxvQkFBTyxDQUFDLFdBQVc7WUFDNUIsT0FBTyxFQUFFLGVBQWU7WUFDeEIsSUFBSSxFQUFFLGlCQUFJLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLCtDQUErQyxDQUFDLENBQUM7WUFDM0YsT0FBTyxFQUFFLHNCQUFRLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztZQUM3QixVQUFVLEVBQUUsR0FBRztZQUNmLFdBQVcsRUFBRTtnQkFDWCxXQUFXLEVBQUUsS0FBSyxDQUFDLFFBQVEsQ0FBQyxVQUFVO2dCQUN0QyxlQUFlLEVBQUUsS0FBSyxDQUFDLFlBQVksQ0FBQyxjQUFjO2dCQUNsRCxvQkFBb0IsRUFBRSxLQUFLLENBQUMsa0JBQWtCLENBQUMsUUFBUSxFQUFFO2dCQUN6RCxrQkFBa0IsRUFBRSxLQUFLLENBQUMsZ0JBQWdCLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsT0FBTzthQUM5RDtTQUNGLENBQUMsQ0FBQztRQUVILElBQUksQ0FBQyxRQUFRLENBQUMsZUFBZSxDQUMzQixJQUFJLHlCQUFlLENBQUM7WUFDbEIsT0FBTyxFQUFFO2dCQUNQLGdDQUFnQztnQkFDaEMsMEJBQTBCO2FBQzNCO1lBQ0QsU0FBUyxFQUFFLENBQUMsR0FBRyxDQUFDO1NBQ2pCLENBQUMsQ0FDSCxDQUFDO1FBRUYsd0ZBQXdGO1FBQ3hGLGtDQUFrQztRQUNsQyxJQUFJLENBQUMsUUFBUSxDQUFDLGVBQWUsQ0FDM0IsSUFBSSx5QkFBZSxDQUFDO1lBQ2xCLE9BQU8sRUFBRTtnQkFDUCx1QkFBdUI7Z0JBQ3ZCLDRCQUE0QjthQUM3QjtZQUNELFNBQVMsRUFBRSxDQUFDLEdBQUcsQ0FBQztTQUNqQixDQUFDLENBQ0gsQ0FBQztRQUVGLDJFQUEyRTtRQUMzRSxJQUFJLENBQUMsUUFBUSxDQUFDLGVBQWUsQ0FDM0IsSUFBSSx5QkFBZSxDQUFDO1lBQ2xCLE9BQU8sRUFBRTtnQkFDUCxtQkFBbUI7YUFDcEI7WUFDRCxTQUFTLEVBQUU7Z0JBQ1QsZUFBZSxtQkFBSyxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsQ0FBQyxNQUFNLElBQUksbUJBQUssQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLENBQUMsT0FBTyxhQUFhLEtBQUssQ0FBQyxRQUFRLENBQUMsVUFBVSxFQUFFO2FBQ3ZHO1NBQ0YsQ0FBQyxDQUNILENBQUM7UUFFRiwyREFBMkQ7UUFDM0QseUVBQXlFO1FBQ3pFLDZFQUE2RTtRQUM3RSxNQUFNLGFBQWEsR0FBRyxLQUFLLENBQUMsb0JBQW9CLElBQUksQ0FBQyxDQUFDO1FBQ3RELElBQUksQ0FBQyxZQUFZLEdBQUcsSUFBSSxpQkFBSSxDQUFDLElBQUksRUFBRSxjQUFjLEVBQUU7WUFDakQsUUFBUSxFQUFFLHFCQUFRLENBQUMsSUFBSSxDQUFDLHNCQUFRLENBQUMsT0FBTyxDQUFDLGFBQWEsQ0FBQyxDQUFDO1lBQ3hELE9BQU8sRUFBRSxLQUFLLEVBQUUscURBQXFEO1NBQ3RFLENBQUMsQ0FBQztRQUVILElBQUksQ0FBQyxZQUFZLENBQUMsU0FBUyxDQUFDLElBQUksbUNBQW9CLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUM7UUFFckUsdUJBQXVCO1FBQ3ZCLHlCQUFlLENBQUMsdUJBQXVCLENBQ3JDLElBQUksQ0FBQyxRQUFRLEVBQ2I7WUFDRTtnQkFDRSxFQUFFLEVBQUUsbUJBQW1CO2dCQUN2QixNQUFNLEVBQUUsMkRBQTJEO2FBQ3BFO1lBQ0Q7Z0JBQ0UsRUFBRSxFQUFFLG1CQUFtQjtnQkFDdkIsTUFBTSxFQUFFLGlEQUFpRDthQUMxRDtZQUNEO2dCQUNFLEVBQUUsRUFBRSxpQkFBaUI7Z0JBQ3JCLE1BQU0sRUFBRSwrQ0FBK0M7YUFDeEQ7U0FDRixFQUNELElBQUksQ0FDTCxDQUFDO0lBQ0osQ0FBQzs7QUE1Rkgsa0NBNkZDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0ICogYXMgcGF0aCBmcm9tICdwYXRoJztcbmltcG9ydCB7IER1cmF0aW9uLCBTdGFjayB9IGZyb20gJ2F3cy1jZGstbGliJztcbmltcG9ydCB7IElEaXN0cmlidXRpb24gfSBmcm9tICdhd3MtY2RrLWxpYi9hd3MtY2xvdWRmcm9udCc7XG5pbXBvcnQgeyBJSW5zdGFuY2UgfSBmcm9tICdhd3MtY2RrLWxpYi9hd3MtZWMyJztcbmltcG9ydCB7IFJ1bGUsIFNjaGVkdWxlIH0gZnJvbSAnYXdzLWNkay1saWIvYXdzLWV2ZW50cyc7XG5pbXBvcnQgeyBMYW1iZGFGdW5jdGlvbiBhcyBMYW1iZGFGdW5jdGlvblRhcmdldCB9IGZyb20gJ2F3cy1jZGstbGliL2F3cy1ldmVudHMtdGFyZ2V0cyc7XG5pbXBvcnQgeyBQb2xpY3lTdGF0ZW1lbnQgfSBmcm9tICdhd3MtY2RrLWxpYi9hd3MtaWFtJztcbmltcG9ydCB7IFJ1bnRpbWUsIENvZGUsIEZ1bmN0aW9uIGFzIExhbWJkYUZ1bmN0aW9uIH0gZnJvbSAnYXdzLWNkay1saWIvYXdzLWxhbWJkYSc7XG5pbXBvcnQgeyBOYWdTdXBwcmVzc2lvbnMgfSBmcm9tICdjZGstbmFnJztcbmltcG9ydCB7IENvbnN0cnVjdCB9IGZyb20gJ2NvbnN0cnVjdHMnO1xuXG4vKipcbiAqIFByb3BzIGZvciBJZGxlTW9uaXRvciBjb25zdHJ1Y3RcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJZGxlTW9uaXRvclByb3BzIHtcbiAgLyoqXG4gICAqIFRoZSBFQzIgaW5zdGFuY2UgdG8gbW9uaXRvclxuICAgKi9cbiAgcmVhZG9ubHkgaW5zdGFuY2U6IElJbnN0YW5jZTtcbiAgLyoqXG4gICAqIFRoZSBDbG91ZEZyb250IGRpc3RyaWJ1dGlvbiB0byBtb25pdG9yIGZvciBhY3Rpdml0eVxuICAgKi9cbiAgcmVhZG9ubHkgZGlzdHJpYnV0aW9uOiBJRGlzdHJpYnV0aW9uO1xuICAvKipcbiAgICogTnVtYmVyIG9mIG1pbnV0ZXMgb2YgaW5hY3Rpdml0eSBiZWZvcmUgc3RvcHBpbmcgdGhlIGluc3RhbmNlXG4gICAqL1xuICByZWFkb25seSBpZGxlVGltZW91dE1pbnV0ZXM6IG51bWJlcjtcbiAgLyoqXG4gICAqIEhvdyBvZnRlbiB0byBjaGVjayBmb3IgaWRsZSBhY3Rpdml0eSAoaW4gbWludXRlcylcbiAgICogQGRlZmF1bHQgNSAtIENoZWNrIGV2ZXJ5IDUgbWludXRlc1xuICAgKi9cbiAgcmVhZG9ubHkgY2hlY2tJbnRlcnZhbE1pbnV0ZXM/OiBudW1iZXI7XG4gIC8qKlxuICAgKiBTa2lwIGluc3RhbmNlIHN0YXR1cyBjaGVja3MgYmVmb3JlIHN0b3BwaW5nXG4gICAqIFdoZW4gdHJ1ZSwgSWRsZU1vbml0b3Igd2lsbCBzdG9wIGlkbGUgaW5zdGFuY2VzIGV2ZW4gaWYgc3RhdHVzIGNoZWNrcyBoYXZlbid0IHBhc3NlZFxuICAgKiBUaGlzIGlzIHVzZWZ1bCBmb3IgaW50ZWdyYXRpb24gdGVzdHMgd2hlcmUgc3RhdHVzIGNoZWNrIGluaXRpYWxpemF0aW9uIHRpbWVcbiAgICogZXhjZWVkcyB0ZXN0IHRpbWVvdXQgbGltaXRzXG4gICAqXG4gICAqIFdBUk5JTkc6IEZvciB0ZXN0aW5nIG9ubHkgLSBpbiBwcm9kdWN0aW9uLCB5b3Ugc2hvdWxkIHdhaXQgZm9yIHN0YXR1cyBjaGVja3NcbiAgICogdG8gcGFzcyBiZWZvcmUgc3RvcHBpbmcgaW5zdGFuY2VzXG4gICAqXG4gICAqIEBkZWZhdWx0IGZhbHNlXG4gICAqL1xuICByZWFkb25seSBza2lwU3RhdHVzQ2hlY2tzPzogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBDb25zdHJ1Y3QgdGhhdCBtb25pdG9ycyBDbG91ZEZyb250IHJlcXVlc3QgbWV0cmljcyBhbmQgc3RvcHMgdGhlIEVDMiBpbnN0YW5jZSB3aGVuIGlkbGVcbiAqL1xuZXhwb3J0IGNsYXNzIElkbGVNb25pdG9yIGV4dGVuZHMgQ29uc3RydWN0IHtcbiAgLyoqXG4gICAqIFRoZSBMYW1iZGEgZnVuY3Rpb24gdGhhdCBwZXJmb3JtcyBpZGxlIG1vbml0b3JpbmdcbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBmdW5jdGlvbjogTGFtYmRhRnVuY3Rpb247XG5cbiAgLyoqXG4gICAqIFRoZSBFdmVudEJyaWRnZSBydWxlIHRoYXQgdHJpZ2dlcnMgaWRsZSBtb25pdG9yaW5nIGNoZWNrc1xuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IHNjaGVkdWxlUnVsZTogUnVsZTtcblxuICBjb25zdHJ1Y3RvcihzY29wZTogQ29uc3RydWN0LCBpZDogc3RyaW5nLCBwcm9wczogSWRsZU1vbml0b3JQcm9wcykge1xuICAgIHN1cGVyKHNjb3BlLCBpZCk7XG5cbiAgICB0aGlzLmZ1bmN0aW9uID0gbmV3IExhbWJkYUZ1bmN0aW9uKHRoaXMsICdGdW5jdGlvbicsIHtcbiAgICAgIHJ1bnRpbWU6IFJ1bnRpbWUuTk9ERUpTXzIwX1gsXG4gICAgICBoYW5kbGVyOiAnaW5kZXguaGFuZGxlcicsXG4gICAgICBjb2RlOiBDb2RlLmZyb21Bc3NldChwYXRoLmpvaW4oX19kaXJuYW1lLCAnLi4vLi4vYXNzZXRzL2lkbGUtbW9uaXRvci9pZGxlLW1vbml0b3IubGFtYmRhJykpLFxuICAgICAgdGltZW91dDogRHVyYXRpb24uc2Vjb25kcygzMCksXG4gICAgICBtZW1vcnlTaXplOiAyNTYsXG4gICAgICBlbnZpcm9ubWVudDoge1xuICAgICAgICBJTlNUQU5DRV9JRDogcHJvcHMuaW5zdGFuY2UuaW5zdGFuY2VJZCxcbiAgICAgICAgRElTVFJJQlVUSU9OX0lEOiBwcm9wcy5kaXN0cmlidXRpb24uZGlzdHJpYnV0aW9uSWQsXG4gICAgICAgIElETEVfVElNRU9VVF9NSU5VVEVTOiBwcm9wcy5pZGxlVGltZW91dE1pbnV0ZXMudG9TdHJpbmcoKSxcbiAgICAgICAgU0tJUF9TVEFUVVNfQ0hFQ0tTOiBwcm9wcy5za2lwU3RhdHVzQ2hlY2tzID8gJ3RydWUnIDogJ2ZhbHNlJyxcbiAgICAgIH0sXG4gICAgfSk7XG5cbiAgICB0aGlzLmZ1bmN0aW9uLmFkZFRvUm9sZVBvbGljeShcbiAgICAgIG5ldyBQb2xpY3lTdGF0ZW1lbnQoe1xuICAgICAgICBhY3Rpb25zOiBbXG4gICAgICAgICAgJ2Nsb3Vkd2F0Y2g6R2V0TWV0cmljU3RhdGlzdGljcycsXG4gICAgICAgICAgJ2Nsb3Vkd2F0Y2g6R2V0TWV0cmljRGF0YScsXG4gICAgICAgIF0sXG4gICAgICAgIHJlc291cmNlczogWycqJ10sXG4gICAgICB9KSxcbiAgICApO1xuXG4gICAgLy8gRGVzY3JpYmVJbnN0YW5jZXMgYW5kIERlc2NyaWJlSW5zdGFuY2VTdGF0dXMgZG9uJ3Qgc3VwcG9ydCByZXNvdXJjZS1sZXZlbCBwZXJtaXNzaW9uc1xuICAgIC8vIFRoZXkgcmVxdWlyZSB3aWxkY2FyZCByZXNvdXJjZXNcbiAgICB0aGlzLmZ1bmN0aW9uLmFkZFRvUm9sZVBvbGljeShcbiAgICAgIG5ldyBQb2xpY3lTdGF0ZW1lbnQoe1xuICAgICAgICBhY3Rpb25zOiBbXG4gICAgICAgICAgJ2VjMjpEZXNjcmliZUluc3RhbmNlcycsXG4gICAgICAgICAgJ2VjMjpEZXNjcmliZUluc3RhbmNlU3RhdHVzJyxcbiAgICAgICAgXSxcbiAgICAgICAgcmVzb3VyY2VzOiBbJyonXSxcbiAgICAgIH0pLFxuICAgICk7XG5cbiAgICAvLyBTdG9wSW5zdGFuY2VzIHN1cHBvcnRzIHJlc291cmNlLWxldmVsIHBlcm1pc3Npb25zLCBzbyB3ZSBjYW4gcmVzdHJpY3QgaXRcbiAgICB0aGlzLmZ1bmN0aW9uLmFkZFRvUm9sZVBvbGljeShcbiAgICAgIG5ldyBQb2xpY3lTdGF0ZW1lbnQoe1xuICAgICAgICBhY3Rpb25zOiBbXG4gICAgICAgICAgJ2VjMjpTdG9wSW5zdGFuY2VzJyxcbiAgICAgICAgXSxcbiAgICAgICAgcmVzb3VyY2VzOiBbXG4gICAgICAgICAgYGFybjphd3M6ZWMyOiR7U3RhY2sub2YodGhpcykucmVnaW9ufToke1N0YWNrLm9mKHRoaXMpLmFjY291bnR9Omluc3RhbmNlLyR7cHJvcHMuaW5zdGFuY2UuaW5zdGFuY2VJZH1gLFxuICAgICAgICBdLFxuICAgICAgfSksXG4gICAgKTtcblxuICAgIC8vIENyZWF0ZSBFdmVudEJyaWRnZSBydWxlIHRvIHRyaWdnZXIgYXQgc3BlY2lmaWVkIGludGVydmFsXG4gICAgLy8gTk9URTogUnVsZSBpcyBjcmVhdGVkIGluIERJU0FCTEVEIHN0YXRlIGFuZCBtdXN0IGJlIGV4cGxpY2l0bHkgZW5hYmxlZFxuICAgIC8vIGFmdGVyIGluc3RhbGxhdGlvbiBjb21wbGV0ZXMgdG8gcHJldmVudCBzdG9wcGluZyB0aGUgaW5zdGFuY2UgZHVyaW5nIHNldHVwXG4gICAgY29uc3QgY2hlY2tJbnRlcnZhbCA9IHByb3BzLmNoZWNrSW50ZXJ2YWxNaW51dGVzID8/IDU7XG4gICAgdGhpcy5zY2hlZHVsZVJ1bGUgPSBuZXcgUnVsZSh0aGlzLCAnU2NoZWR1bGVSdWxlJywge1xuICAgICAgc2NoZWR1bGU6IFNjaGVkdWxlLnJhdGUoRHVyYXRpb24ubWludXRlcyhjaGVja0ludGVydmFsKSksXG4gICAgICBlbmFibGVkOiBmYWxzZSwgLy8gU3RhcnQgZGlzYWJsZWQsIHdpbGwgYmUgZW5hYmxlZCBhZnRlciBpbnN0YWxsYXRpb25cbiAgICB9KTtcblxuICAgIHRoaXMuc2NoZWR1bGVSdWxlLmFkZFRhcmdldChuZXcgTGFtYmRhRnVuY3Rpb25UYXJnZXQodGhpcy5mdW5jdGlvbikpO1xuXG4gICAgLy8gQ0RLLW5hZyBzdXBwcmVzc2lvbnNcbiAgICBOYWdTdXBwcmVzc2lvbnMuYWRkUmVzb3VyY2VTdXBwcmVzc2lvbnMoXG4gICAgICB0aGlzLmZ1bmN0aW9uLFxuICAgICAgW1xuICAgICAgICB7XG4gICAgICAgICAgaWQ6ICdBd3NTb2x1dGlvbnMtSUFNNCcsXG4gICAgICAgICAgcmVhc29uOiAnTWFuYWdlZCBwb2xpY2llcyBhY2NlcHRhYmxlIGZvciB3b3Jrc2hvcCBMYW1iZGEgZnVuY3Rpb25zJyxcbiAgICAgICAgfSxcbiAgICAgICAge1xuICAgICAgICAgIGlkOiAnQXdzU29sdXRpb25zLUlBTTUnLFxuICAgICAgICAgIHJlYXNvbjogJ0Nsb3VkV2F0Y2ggbWV0cmljcyByZXF1aXJlIHdpbGRjYXJkIHBlcm1pc3Npb25zJyxcbiAgICAgICAgfSxcbiAgICAgICAge1xuICAgICAgICAgIGlkOiAnQXdzU29sdXRpb25zLUwxJyxcbiAgICAgICAgICByZWFzb246ICdMYXRlc3QgcnVudGltZSBub3QgcmVxdWlyZWQgZm9yIHRoaXMgZnVuY3Rpb24nLFxuICAgICAgICB9LFxuICAgICAgXSxcbiAgICAgIHRydWUsXG4gICAgKTtcbiAgfVxufVxuIl19

package/lib/installer/installer.d.ts

@@ -1,5 +1,5 @@
 import { Construct } from 'constructs';
-import { LinuxFlavorType } from '../vscode-server';
+import { LinuxFlavorType, CustomInstallStep } from '../vscode-server';
 interface InstallerOptionsBase {
     /**
      * The ec2 instance id to install the ssm document on
@@ -92,6 +92,12 @@ interface InstallerOptionsBase {
      * @default - no folders created
      */
     readonly folderZipS3Path?: string;
+    /**
+     * Custom installation steps to extend the SSM document
+     *
+     * @default - no custom installation steps
+     */
+    readonly customInstallSteps?: CustomInstallStep[];
 }
 export interface InstallerOptions extends InstallerOptionsBase {
 }