@bluedynamics/cdk8s-plone 0.1.5 → 0.1.7

package/documentation/sources/reference/configuration-options.md

@@ -0,0 +1,370 @@
+# Configuration Options
+
+Complete reference for all configuration options in cdk8s-plone.
+
+## Key Constructs
+
+### `Plone`
+
+Main construct for deploying Plone CMS. Supports two variants:
+- **VOLTO**: Modern React frontend with REST API backend (default)
+- **CLASSICUI**: Traditional server-side rendered Plone
+
+**Properties:**
+- `backendServiceName` - Name of the backend Kubernetes service
+- `frontendServiceName` - Name of the frontend service (VOLTO only)
+- `variant` - Deployment variant (VOLTO or CLASSICUI)
+- `siteId` - Plone site ID in ZODB (default: 'Plone')
+
+**Example:**
+```typescript
+import { Plone, PloneVariant } from '@bluedynamics/cdk8s-plone';
+
+new Plone(chart, 'my-plone', {
+  variant: PloneVariant.VOLTO,
+  siteId: 'MySite',
+  backend: {
+    image: 'plone/plone-backend:6.1.3',
+    replicas: 3,
+  },
+  frontend: {
+    image: 'plone/plone-frontend:16.0.0',
+    replicas: 2,
+  },
+});
+```
+
+---
+
+### `PloneHttpcache`
+
+Varnish HTTP caching layer using the [kube-httpcache](https://github.com/mittwald/kube-httpcache) Helm chart. Provides cluster-wide cache invalidation.
+
+**Properties:**
+- `httpcacheServiceName` - Name of the Varnish service
+
+**Example:**
+```typescript
+import { PloneHttpcache } from '@bluedynamics/cdk8s-plone';
+
+new PloneHttpcache(chart, 'cache', {
+  plone: ploneInstance,
+  existingSecret: 'varnish-secret',
+  replicas: 2,
+});
+```
+
+---
+
+## Configuration Interfaces
+
+### `PloneOptions`
+
+Main configuration interface for the Plone construct.
+
+| Property | Type | Required | Default | Description |
+|----------|------|----------|---------|-------------|
+| `version` | `string` | No | - | Version of your project |
+| `siteId` | `string` | No | `'Plone'` | Plone site ID in ZODB |
+| `variant` | `PloneVariant` | No | `VOLTO` | Deployment variant (VOLTO or CLASSICUI) |
+| `backend` | `PloneBaseOptions` | Yes | - | Backend configuration |
+| `frontend` | `PloneBaseOptions` | Conditional | - | Frontend configuration (required for VOLTO) |
+| `imagePullSecrets` | `string[]` | No | - | Image pull secrets for private registries |
+
+**Example:**
+```typescript
+const options: PloneOptions = {
+  version: '1.0.0',
+  siteId: 'MySite',
+  variant: PloneVariant.VOLTO,
+  backend: { /* ... */ },
+  frontend: { /* ... */ },
+  imagePullSecrets: ['my-registry-secret'],
+};
+```
+
+---
+
+### `PloneBaseOptions`
+
+Configuration for backend or frontend components.
+
+#### Container Configuration
+
+| Property | Type | Required | Default | Description |
+|----------|------|----------|---------|-------------|
+| `image` | `string` | Yes | - | Container image (e.g., 'plone/plone-backend:6.1.3') |
+| `imagePullPolicy` | `string` | No | `'IfNotPresent'` | Image pull policy |
+| `replicas` | `number` | No | `2` | Number of pod replicas |
+| `environment` | `Env` | No | - | Environment variables (cdk8s-plus-30.Env) |
+
+**Example:**
+```typescript
+import { Env } from 'cdk8s-plus-30';
+
+backend: {
+  image: 'plone/plone-backend:6.1.3',
+  replicas: 3,
+  imagePullPolicy: 'Always',
+  environment: {
+    variables: {
+      SITE: Env.value('MySite'),
+      DEBUG_MODE: Env.value('off'),
+    },
+  },
+}
+```
+
+#### Resource Configuration
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `requestCpu` | `string` | CPU request (e.g., '500m', '1') |
+| `limitCpu` | `string` | CPU limit |
+| `requestMemory` | `string` | Memory request (e.g., '512Mi', '1Gi') |
+| `limitMemory` | `string` | Memory limit |
+
+**Example:**
+```typescript
+backend: {
+  image: 'plone/plone-backend:6.1.3',
+  requestCpu: '500m',
+  limitCpu: '2',
+  requestMemory: '512Mi',
+  limitMemory: '2Gi',
+}
+```
+
+#### High Availability
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `minAvailable` | `number` | Minimum pods available during updates (for PodDisruptionBudget) |
+| `maxUnavailable` | `number` | Maximum unavailable pods during updates |
+
+**Example:**
+```typescript
+backend: {
+  image: 'plone/plone-backend:6.1.3',
+  replicas: 5,
+  minAvailable: 3,  // At least 3 pods must be available during updates
+}
+```
+
+#### Readiness Probe
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `readinessEnabled` | `boolean` | `true` | Enable readiness probe |
+| `readinessInitialDelaySeconds` | `number` | - | Seconds before first probe |
+| `readinessTimeoutSeconds` | `number` | - | Probe timeout |
+| `readinessPeriodSeconds` | `number` | - | Probe frequency |
+| `readinessSuccessThreshold` | `number` | - | Consecutive successes required |
+| `readinessFailureThreshold` | `number` | - | Consecutive failures before marking unready |
+
+**Example:**
+```typescript
+backend: {
+  image: 'plone/plone-backend:6.1.3',
+  readinessEnabled: true,
+  readinessInitialDelaySeconds: 10,
+  readinessTimeoutSeconds: 5,
+  readinessPeriodSeconds: 10,
+  readinessFailureThreshold: 3,
+}
+```
+
+#### Liveness Probe
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `livenessEnabled` | `boolean` | `false` | Enable liveness probe (recommended `true` for frontend) |
+| `livenessInitialDelaySeconds` | `number` | - | Seconds before first probe |
+| `livenessTimeoutSeconds` | `number` | - | Probe timeout |
+| `livenessPeriodSeconds` | `number` | - | Probe frequency |
+| `livenessSuccessThreshold` | `number` | - | Consecutive successes required |
+| `livenessFailureThreshold` | `number` | - | Consecutive failures before restart |
+
+**Example:**
+```typescript
+frontend: {
+  image: 'plone/plone-frontend:16.0.0',
+  livenessEnabled: true,  // Recommended for frontend
+  livenessInitialDelaySeconds: 30,
+  livenessTimeoutSeconds: 5,
+  livenessPeriodSeconds: 30,
+  livenessFailureThreshold: 3,
+}
+```
+
+#### Annotations
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `annotations` | `Record<string, string>` | Deployment metadata annotations |
+| `podAnnotations` | `Record<string, string>` | Pod template annotations (e.g., for Prometheus) |
+| `serviceAnnotations` | `Record<string, string>` | Service annotations (e.g., for external-dns) |
+
+**Example:**
+```typescript
+backend: {
+  image: 'plone/plone-backend:6.1.3',
+  podAnnotations: {
+    'prometheus.io/scrape': 'true',
+    'prometheus.io/port': '8080',
+  },
+  serviceAnnotations: {
+    'external-dns.alpha.kubernetes.io/hostname': 'backend.example.com',
+  },
+}
+```
+
+---
+
+### `PloneHttpcacheOptions`
+
+Configuration for the Varnish HTTP cache layer.
+
+| Property | Type | Required | Default | Description |
+|----------|------|----------|---------|-------------|
+| `plone` | `Plone` | Yes | - | Plone construct to attach cache to |
+| `varnishVcl` | `string` | No | - | VCL configuration as string |
+| `varnishVclFile` | `string` | No | - | Path to VCL configuration file |
+| `existingSecret` | `string` | No | - | Kubernetes secret for Varnish admin credentials |
+| `replicas` | `number` | No | `2` | Number of Varnish replicas |
+| `requestCpu` | `string` | No | - | CPU request |
+| `limitCpu` | `string` | No | - | CPU limit |
+| `requestMemory` | `string` | No | - | Memory request |
+| `limitMemory` | `string` | No | - | Memory limit |
+| `servicemonitor` | `boolean` | No | `false` | Enable Prometheus ServiceMonitor |
+| `exporterEnabled` | `boolean` | No | `true` | Enable Prometheus exporter sidecar |
+| `chartVersion` | `string` | No | latest | kube-httpcache Helm chart version |
+
+**Example:**
+```typescript
+new PloneHttpcache(chart, 'cache', {
+  plone: ploneInstance,
+  existingSecret: 'varnish-secret',
+  replicas: 3,
+  requestCpu: '250m',
+  limitCpu: '1',
+  requestMemory: '256Mi',
+  limitMemory: '1Gi',
+  servicemonitor: true,
+  exporterEnabled: true,
+});
+```
+
+**VCL Configuration:**
+```typescript
+// Inline VCL
+new PloneHttpcache(chart, 'cache', {
+  plone: ploneInstance,
+  varnishVcl: `
+    vcl 4.1;
+    backend default {
+      .host = "backend-service";
+      .port = "8080";
+    }
+  `,
+});
+
+// VCL from file
+new PloneHttpcache(chart, 'cache', {
+  plone: ploneInstance,
+  varnishVclFile: './varnish/default.vcl',
+});
+```
+
+---
+
+## PloneVariant Enum
+
+Defines the deployment variant:
+
+| Value | Description |
+|-------|-------------|
+| `PloneVariant.VOLTO` | Modern React frontend with REST API backend (default) |
+| `PloneVariant.CLASSICUI` | Traditional server-side rendered Plone |
+
+**Example:**
+```typescript
+import { PloneVariant } from '@bluedynamics/cdk8s-plone';
+
+// Volto (modern)
+variant: PloneVariant.VOLTO
+
+// Classic UI
+variant: PloneVariant.CLASSICUI
+```
+
+---
+
+## Complete Example
+
+```typescript
+import { App, Chart } from 'cdk8s';
+import { Plone, PloneVariant, PloneHttpcache } from '@bluedynamics/cdk8s-plone';
+import { Env } from 'cdk8s-plus-30';
+
+const app = new App();
+const chart = new Chart(app, 'PloneDeployment');
+
+const plone = new Plone(chart, 'my-plone', {
+  version: '1.0.0',
+  siteId: 'MySite',
+  variant: PloneVariant.VOLTO,
+  imagePullSecrets: ['registry-secret'],
+
+  backend: {
+    image: 'plone/plone-backend:6.1.3',
+    replicas: 3,
+    requestCpu: '500m',
+    limitCpu: '2',
+    requestMemory: '512Mi',
+    limitMemory: '2Gi',
+    minAvailable: 2,
+    readinessEnabled: true,
+    readinessInitialDelaySeconds: 10,
+    environment: {
+      variables: {
+        SITE: Env.value('MySite'),
+      },
+    },
+    podAnnotations: {
+      'prometheus.io/scrape': 'true',
+    },
+  },
+
+  frontend: {
+    image: 'plone/plone-frontend:16.0.0',
+    replicas: 2,
+    requestCpu: '250m',
+    limitCpu: '1',
+    requestMemory: '256Mi',
+    limitMemory: '1Gi',
+    livenessEnabled: true,
+    livenessInitialDelaySeconds: 30,
+  },
+});
+
+new PloneHttpcache(chart, 'cache', {
+  plone: plone,
+  existingSecret: 'varnish-secret',
+  replicas: 2,
+  requestCpu: '250m',
+  requestMemory: '256Mi',
+  servicemonitor: true,
+});
+
+app.synth();
+```
+
+---
+
+## See Also
+
+- [API Documentation](api/) - Complete API reference
+- [Quick Start Tutorial](../tutorials/01-quick-start.md) - Get started guide
+- [Scale Resources](../how-to/scale-resources.md) - How to adjust resources
+- [Configure Monitoring](../how-to/configure-monitoring.md) - Prometheus setup

package/documentation/sources/reference/index.md

@@ -0,0 +1,59 @@
+```{image} ../_static/kup6s-icon-reference.svg
+:align: center
+:class: section-icon-large
+```
+
+# Reference
+
+**Information-oriented technical specifications and configurations for cdk8s-plone.**
+
+Reference guides provide detailed technical information about cdk8s-plone's API, configuration options, and component specifications. They describe how things work and what parameters are available.
+
+## API Reference
+
+*This section will contain auto-generated or detailed documentation for:*
+- Main chart classes
+- Configuration interfaces
+- Individual construct classes
+- Utility functions and validators
+
+## Configuration Reference
+
+```{toctree}
+---
+maxdepth: 1
+titlesonly: true
+---
+configuration-options
+```
+
+## Component Specifications
+
+```{toctree}
+---
+maxdepth: 1
+titlesonly: true
+---
+```
+
+*Component specifications will be added in future releases.*
+
+## API Documentation
+
+See the `api/` directory for detailed construct documentation:
+
+```{toctree}
+---
+maxdepth: 1
+glob: true
+---
+api/*
+```
+
+---
+
+**Getting started?** Begin with the [Tutorials](../tutorials/index.md) for hands-on learning.
+
+**Solving a specific problem?** Check the [How-To Guides](../how-to/index.md) for task-oriented solutions.
+
+**Understanding concepts?** Read the [Explanation](../explanation/index.md) section for architecture and design.

package/documentation/sources/tutorials/01-quick-start.md

@@ -0,0 +1,157 @@
+# Quick Start
+
+This tutorial will guide you through deploying your first Plone instance using cdk8s-plone.
+
+## Prerequisites
+
+Before you start, ensure you have:
+
+- **Node.js 16+** and npm installed
+- **kubectl** configured to access your Kubernetes cluster
+- Basic familiarity with Kubernetes and TypeScript
+- A Kubernetes cluster (local or remote)
+
+For detailed prerequisites, see [Setup Prerequisites](../how-to/setup-prerequisites.md).
+
+## Step 1: Create a CDK8S Project
+
+Create a new CDK8S TypeScript project:
+
+```bash
+# Create project directory
+mkdir my-plone-deployment
+cd my-plone-deployment
+
+# Initialize CDK8S project
+cdk8s init typescript-app
+```
+
+This creates a basic CDK8S project structure.
+
+## Step 2: Install cdk8s-plone
+
+Install the cdk8s-plone library:
+
+```bash
+npm install @bluedynamics/cdk8s-plone
+```
+
+The library is also available for Python via PyPI:
+
+```bash
+pip install cdk8s-plone
+```
+
+## Step 3: Create a Basic Plone Deployment
+
+Edit `main.ts` with the following code:
+
+```typescript
+import { App, Chart } from 'cdk8s';
+import { Plone, PloneVariant } from '@bluedynamics/cdk8s-plone';
+
+const app = new App();
+const chart = new Chart(app, 'PloneDeployment');
+
+new Plone(chart, 'my-plone', {
+  variant: PloneVariant.VOLTO,
+  backend: {
+    image: 'plone/plone-backend:6.1.3',
+    replicas: 3,
+  },
+  frontend: {
+    image: 'plone/plone-frontend:16.0.0',
+    replicas: 2,
+  },
+});
+
+app.synth();
+```
+
+This creates:
+- A Plone backend with 3 replicas
+- A Volto frontend with 2 replicas
+- All necessary Kubernetes services and deployments
+
+## Step 4: Generate Kubernetes Manifests
+
+Generate the Kubernetes manifests:
+
+```bash
+cdk8s synth
+```
+
+This creates YAML files in the `dist/` directory containing all Kubernetes resources.
+
+## Step 5: Deploy to Kubernetes
+
+Apply the generated manifests to your cluster:
+
+```bash
+kubectl apply -f dist/
+```
+
+Check the deployment status:
+
+```bash
+kubectl get pods
+kubectl get services
+```
+
+## Step 6: Access Your Plone Site
+
+Once all pods are running, access your Plone site:
+
+```bash
+# Port-forward to the frontend service
+kubectl port-forward service/my-plone-frontend 3000:3000
+
+# Open in browser
+open http://localhost:3000
+```
+
+## Adding HTTP Caching (Optional)
+
+For production deployments, add Varnish HTTP caching:
+
+```typescript
+import { PloneHttpcache } from '@bluedynamics/cdk8s-plone';
+
+const plone = new Plone(chart, 'my-plone', {
+  variant: PloneVariant.VOLTO,
+  backend: { image: 'plone/plone-backend:6.1.3' },
+  frontend: { image: 'plone/plone-frontend:16.0.0' },
+});
+
+new PloneHttpcache(chart, 'cache', {
+  plone: plone,
+  existingSecret: 'varnish-secret',
+  replicas: 2,
+});
+```
+
+This adds a Varnish caching layer with cluster-wide cache invalidation using [kube-httpcache](https://github.com/mittwald/kube-httpcache).
+
+## Next Steps
+
+Now that you have a basic Plone deployment:
+
+- **Configure resources**: See [Scale Resources](../how-to/scale-resources.md) to adjust CPU and memory
+- **Add monitoring**: Configure [Prometheus metrics](../how-to/configure-monitoring.md)
+- **Explore variants**: Learn about [Classic UI vs Volto](../explanation/plone-variants.md)
+
+## Troubleshooting
+
+**Pods not starting?**
+- Check pod logs: `kubectl logs <pod-name>`
+- Verify images are accessible: `kubectl describe pod <pod-name>`
+
+**Can't access the site?**
+- Ensure port-forward is running
+- Check service endpoints: `kubectl get endpoints`
+
+For more help, see the [Troubleshooting guide](../how-to/troubleshooting.md).
+
+---
+
+**Complete example**: See the [cdk8s-plone-example](https://github.com/bluedynamics/cdk8s-plone-example) repository for a full working example.

package/documentation/sources/tutorials/index.md

@@ -0,0 +1,48 @@
+```{image} ../_static/kup6s-icon-tutorials.svg
+:align: center
+:class: section-icon-large
+```
+
+# Tutorials
+
+**Learning-oriented guides that take you through a series of steps to complete a project.**
+
+Tutorials are lessons that help you gain practical skills and familiarity with cdk8s-plone. They are designed to be followed step-by-step and will get you up and running.
+
+## What you'll learn
+
+These tutorials will teach you how to:
+
+- Deploy a basic Plone instance using cdk8s-plone
+- Configure PostgreSQL backend
+- Customize component resources and settings
+- Test your deployment
+
+## Available Tutorials
+
+```{toctree}
+---
+maxdepth: 1
+titlesonly: true
+---
+01-quick-start
+```
+
+## Before you start
+
+These tutorials assume you have:
+- Basic familiarity with Kubernetes concepts
+- Node.js 16+ and npm installed
+- A Kubernetes cluster (local or remote)
+- kubectl configured to access your cluster
+- Basic TypeScript knowledge
+
+If you're new to CDK8S, we recommend reading the [CDK8S documentation](https://cdk8s.io/) first to understand how constructs work.
+
+---
+
+**Looking for practical guidance?** Check out the [How-To Guides](../how-to/index.md) for specific solutions.
+
+**Need technical details?** See the [Reference](../reference/index.md) section for API documentation.
+
+**Want to understand the architecture?** Read the [Explanation](../explanation/index.md) section for concepts and design decisions.

package/lib/httpcache.js

@@ -113,5 +113,5 @@ class PloneHttpcache extends constructs_1.Construct {
 }
 exports.PloneHttpcache = PloneHttpcache;
 _a = JSII_RTTI_SYMBOL_1;
-PloneHttpcache[_a] = { fqn: "@bluedynamics/cdk8s-plone.PloneHttpcache", version: "0.1.5" };
+PloneHttpcache[_a] = { fqn: "@bluedynamics/cdk8s-plone.PloneHttpcache", version: "0.1.7" };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaHR0cGNhY2hlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2h0dHBjYWNoZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQUFBLHlCQUF5QjtBQUN6Qiw2QkFBNkI7QUFDN0IsaUNBQTZCO0FBQzdCLDJDQUF1QztBQTZGdkM7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBQ0gsTUFBYSxjQUFlLFNBQVEsc0JBQVM7SUFPM0MsWUFBWSxLQUFnQixFQUFFLEVBQVUsRUFBRSxPQUE4QjtRQUN0RSxLQUFLLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBQ2pCLElBQUksVUFBa0IsQ0FBQztRQUN2QixJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsRUFBRSxDQUFDO1lBQ3hCLElBQUksT0FBZSxDQUFDO1lBQ3BCLElBQUksQ0FBQyxPQUFPLENBQUMsY0FBYyxFQUFFLENBQUM7Z0JBQzVCLE9BQU8sR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxRQUFRLEVBQUUsaUJBQWlCLENBQUMsQ0FBQztZQUM5RCxDQUFDO2lCQUFNLENBQUM7Z0JBQ04sT0FBTyxHQUFHLE9BQU8sQ0FBQyxjQUFjLENBQUM7WUFDbkMsQ0FBQztZQUNELFVBQVUsR0FBRyxFQUFFLENBQUMsWUFBWSxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQztRQUNoRCxDQUFDO2FBQU0sQ0FBQztZQUNOLFVBQVUsR0FBRyxPQUFPLENBQUMsVUFBVSxDQUFDO1FBQ2xDLENBQUM7UUFDRCxNQUFNLFFBQVEsR0FBRyxPQUFPLENBQUMsVUFBVSxJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUM7UUFDNUQsTUFBTSxTQUFTLEdBQUcsSUFBSSxZQUFJLENBQUMsSUFBSSxFQUFFLFdBQVcsRUFBRTtZQUM1Qyx1REFBdUQ7WUFDdkQsSUFBSSxFQUFFLDBCQUEwQjtZQUNoQyxLQUFLLEVBQUUsZ0JBQWdCO1lBQ3ZCLE9BQU8sRUFBRSxPQUFPLENBQUMsWUFBWTtZQUM3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aW1wb3J0ICogYXMgcGF0aCBmcm9tICdwYXRoJztcbmltcG9ydCB7IEhlbG0gfSBmcm9tICdjZGs4cyc7XG5pbXBvcnQgeyBDb25zdHJ1Y3QgfSBmcm9tICdjb25zdHJ1Y3RzJztcbmltcG9ydCB7IFBsb25lIH0gZnJvbSAnLi9wbG9uZSc7XG5cbi8qKlxuICogQ29uZmlndXJhdGlvbiBvcHRpb25zIGZvciBQbG9uZUh0dHBjYWNoZSAoVmFybmlzaCBjYWNoaW5nIGxheWVyKS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQbG9uZUh0dHBjYWNoZU9wdGlvbnMge1xuICAvKipcbiAgICogVGhlIFBsb25lIGNvbnN0cnVjdCB0byBhdHRhY2ggdGhlIEhUVFAgY2FjaGUgdG8uXG4gICAqIFRoZSBjYWNoZSB3aWxsIGF1dG9tYXRpY2FsbHkgY29ubmVjdCB0byB0aGUgYmFja2VuZCBhbmQgZnJvbnRlbmQgc2VydmljZXMuXG4gICAqL1xuICByZWFkb25seSBwbG9uZTogUGxvbmU7XG5cbiAgLyoqXG4gICAqIFZhcm5pc2ggVkNMIGNvbmZpZ3VyYXRpb24gYXMgYSBzdHJpbmcuXG4gICAqIElmIHByb3ZpZGVkLCB0aGlzIHRha2VzIHByZWNlZGVuY2Ugb3ZlciB2YXJuaXNoVmNsRmlsZS5cbiAgICogQGRlZmF1bHQgLSBsb2FkZWQgZnJvbSB2YXJuaXNoVmNsRmlsZSBvciBkZWZhdWx0IGNvbmZpZyBmaWxlXG4gICAqL1xuICByZWFkb25seSB2YXJuaXNoVmNsPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBQYXRoIHRvIGEgVmFybmlzaCBWQ0wgY29uZmlndXJhdGlvbiBmaWxlLlxuICAgKiBJZiBub3QgcHJvdmlkZWQsIHVzZXMgdGhlIGRlZmF1bHQgVkNMIGZpbGUgaW5jbHVkZWQgaW4gdGhlIGxpYnJhcnkuXG4gICAqIEBkZWZhdWx0IC0gdXNlcyBkZWZhdWx0IGNvbmZpZy92YXJuaXNoLnRwbC52Y2xcbiAgICovXG4gIHJlYWRvbmx5IHZhcm5pc2hWY2xGaWxlPzogc3RyaW5nIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBOYW1lIG9mIGFuIGV4aXN0aW5nIEt1YmVybmV0ZXMgc2VjcmV0IGNvbnRhaW5pbmcgVmFybmlzaCBhZG1pbiBjcmVkZW50aWFscy5cbiAgICogVGhlIHNlY3JldCBzaG91bGQgYmUgY3JlYXRlZCBzZXBhcmF0ZWx5IGluIHRoZSBzYW1lIG5hbWVzcGFjZS5cbiAgICogQGRlZmF1bHQgLSB1bmRlZmluZWQgKG5vIGV4aXN0aW5nIHNlY3JldClcbiAgICovXG4gIHJlYWRvbmx5IGV4aXN0aW5nU2VjcmV0Pzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDUFUgbGltaXQgZm9yIFZhcm5pc2ggcG9kcy5cbiAgICogQGRlZmF1bHQgJzUwMG0nXG4gICAqL1xuICByZWFkb25seSBsaW1pdENwdT86IHN0cmluZztcblxuICAvKipcbiAgICogTWVtb3J5IGxpbWl0IGZvciBWYXJuaXNoIHBvZHMuXG4gICAqIEBkZWZhdWx0ICc1MDBNaSdcbiAgICovXG4gIHJlYWRvbmx5IGxpbWl0TWVtb3J5Pzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDUFUgcmVxdWVzdCBmb3IgVmFybmlzaCBwb2RzLlxuICAgKiBAZGVmYXVsdCAnMTAwbSdcbiAgICovXG4gIHJlYWRvbmx5IHJlcXVlc3RDcHU/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIE1lbW9yeSByZXF1ZXN0IGZvciBWYXJuaXNoIHBvZHMuXG4gICAqIEBkZWZhdWx0ICcxMDBNaSdcbiAgICovXG4gIHJlYWRvbmx5IHJlcXVlc3RNZW1vcnk/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEVuYWJsZSBQcm9tZXRoZXVzIFNlcnZpY2VNb25pdG9yIGZvciBtZXRyaWNzIGNvbGxlY3Rpb24uXG4gICAqIFJlcXVpcmVzIFByb21ldGhldXMgT3BlcmF0b3IgdG8gYmUgaW5zdGFsbGVkIGluIHRoZSBjbHVzdGVyLlxuICAgKiBAZGVmYXVsdCBmYWxzZVxuICAgKi9cbiAgcmVhZG9ubHkgc2VydmljZW1vbml0b3I/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBFbmFibGUgdGhlIFByb21ldGhldXMgZXhwb3J0ZXIgZm9yIFZhcm5pc2ggbWV0cmljcy5cbiAgICogV2hlbiBlbmFibGVkLCB0aGUgZXhwb3J0ZXIgc2lkZWNhciBjb250YWluZXIgd2lsbCBiZSBkZXBsb3llZCBhbG9uZ3NpZGUgVmFybmlzaC5cbiAgICogQGRlZmF1bHQgdHJ1ZVxuICAgKi9cbiAgcmVhZG9ubHkgZXhwb3J0ZXJFbmFibGVkPzogYm9vbGVhbjtcblxuICAvKipcbiAgICogVmVyc2lvbiBvZiB0aGUga3ViZS1odHRwY2FjaGUgSGVsbSBjaGFydCB0byB1c2UuXG4gICAqIElmIG5vdCBzcGVjaWZpZWQsIHRoZSBsYXRlc3QgdmVyc2lvbiBmcm9tIHRoZSByZXBvc2l0b3J5IHdpbGwgYmUgdXNlZC5cbiAgICogQGRlZmF1bHQgdW5kZWZpbmVkIChsYXRlc3QpXG4gICAqL1xuICByZWFkb25seSBjaGFydFZlcnNpb24/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFZlcnNpb24gb2YgdGhlIGt1YmUtaHR0cGNhY2hlIENvbnRhaW5lciBJbWFnZSB0byB1c2UuXG4gICAqIElmIG5vdCBzcGVjaWZpZWQsIHRoZSBsYXRlc3QgdmVyc2lvbiBmcm9tIHRoZSByZXBvc2l0b3J5IHdpbGwgYmUgdXNlZC5cbiAgICogQGRlZmF1bHQgdW5kZWZpbmVkIChjaGFydFZlcnNpb24gPSB3aXRoIGVhY2ggY2hhcnQgcmVsZWFzZSB0aGVyZSBpcyBhbiBpbWFnZSByZWxlYXNlIHRvbyApXG4gICAqL1xuICByZWFkb25seSBhcHBWZXJzaW9uPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBOdW1iZXIgb2YgVmFybmlzaCBwb2QgcmVwbGljYXMgdG8gcnVuLlxuICAgKiBAZGVmYXVsdCAyXG4gICAqL1xuICByZWFkb25seSByZXBsaWNhcz86IG51bWJlcjtcbn1cblxuLyoqXG4gKiBQbG9uZUh0dHBjYWNoZSBjb25zdHJ1Y3QgZm9yIGRlcGxveWluZyBWYXJuaXNoIEhUVFAgY2FjaGluZyBsYXllci5cbiAqXG4gKiBVc2VzIHRoZSBtaXR0d2FsZC9rdWJlLWh0dHBjYWNoZSBIZWxtIGNoYXJ0IHRvIGRlcGxveSBWYXJuaXNoIGFzIGFcbiAqIGNhY2hpbmcgcHJveHkgaW4gZnJvbnQgb2YgUGxvbmUgYmFja2VuZCBhbmQvb3IgZnJvbnRlbmQgc2VydmljZXMuXG4gKlxuICogVGhlIGNhY2hlIGF1dG9tYXRpY2FsbHkgY29ubmVjdHMgdG8gdGhlIFBsb25lIHNlcnZpY2VzIGFuZCBwcm92aWRlc1xuICogSFRUUCBjYWNoZSBpbnZhbGlkYXRpb24gY2FwYWJpbGl0aWVzLlxuICpcbiAqIEBleGFtcGxlXG4gKiBjb25zdCBwbG9uZSA9IG5ldyBQbG9uZShjaGFydCwgJ3Bsb25lJyk7XG4gKiBjb25zdCBjYWNoZSA9IG5ldyBQbG9uZUh0dHBjYWNoZShjaGFydCwgJ2NhY2hlJywge1xuICogICBwbG9uZTogcGxvbmUsXG4gKiAgIGV4aXN0aW5nU2VjcmV0OiAndmFybmlzaC1zZWNyZXQnLFxuICogfSk7XG4gKi9cbmV4cG9ydCBjbGFzcyBQbG9uZUh0dHBjYWNoZSBleHRlbmRzIENvbnN0cnVjdCB7XG4gIC8qKlxuICAgKiBOYW1lIG9mIHRoZSBWYXJuaXNoIHNlcnZpY2UgY3JlYXRlZCBieSB0aGUgSGVsbSBjaGFydC5cbiAgICogVXNlIHRoaXMgdG8gcmVmZXJlbmNlIHRoZSBjYWNoZSBzZXJ2aWNlIGZyb20gaW5ncmVzcyBvciBvdGhlciBjb25zdHJ1Y3RzLlxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGh0dHBjYWNoZVNlcnZpY2VOYW1lOiBzdHJpbmc7XG5cbiAgY29uc3RydWN0b3Ioc2NvcGU6IENvbnN0cnVjdCwgaWQ6IHN0cmluZywgb3B0aW9uczogUGxvbmVIdHRwY2FjaGVPcHRpb25zKSB7XG4gICAgc3VwZXIoc2NvcGUsIGlkKTtcbiAgICBsZXQgdmFybmlzaFZjbDogc3RyaW5nO1xuICAgIGlmICghb3B0aW9ucy52YXJuaXNoVmNsKSB7XG4gICAgICBsZXQgdmNsUGF0aDogc3RyaW5nO1xuICAgICAgaWYgKCFvcHRpb25zLnZhcm5pc2hWY2xGaWxlKSB7XG4gICAgICAgIHZjbFBhdGggPSBwYXRoLmpvaW4oX19kaXJuYW1lLCAnY29uZmlnJywgJ3Zhcm5pc2gudHBsLnZjbCcpO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgdmNsUGF0aCA9IG9wdGlvbnMudmFybmlzaFZjbEZpbGU7XG4gICAgICB9XG4gICAgICB2YXJuaXNoVmNsID0gZnMucmVhZEZpbGVTeW5jKHZjbFBhdGgsICd1dGY4Jyk7XG4gICAgfSBlbHNlIHtcbiAgICAgIHZhcm5pc2hWY2wgPSBvcHRpb25zLnZhcm5pc2hWY2w7XG4gICAgfVxuICAgIGNvbnN0IGltYWdlVGFnID0gb3B0aW9ucy5hcHBWZXJzaW9uID8/IG9wdGlvbnMuY2hhcnRWZXJzaW9uO1xuICAgIGNvbnN0IGh0dHBjYWNoZSA9IG5ldyBIZWxtKHRoaXMsICdodHRwY2FjaGUnLCB7XG4gICAgICAvLyBzZWUgaHR0cHM6Ly9naXRodWIuY29tL21pdHR3YWxkL2t1YmUtaHR0cGNhY2hlL2NoYXJ0XG4gICAgICByZXBvOiAnaHR0cHM6Ly9oZWxtLm1pdHR3YWxkLmRlJyxcbiAgICAgIGNoYXJ0OiAna3ViZS1odHRwY2FjaGUnLFxuICAgICAgdmVyc2lvbjogb3B0aW9ucy5jaGFydFZlcnNpb24sXG4gICAgICB2YWx1ZXM6IHtcbiAgICAgICAgcmVwbGljYUNvdW50OiBvcHRpb25zLnJlcGxpY2FzID8/IDIsXG4gICAgICAgIC4uLihpbWFnZVRhZyAmJiB7IGltYWdlOiB7IHRhZzogaW1hZ2VUYWcgfSB9KSxcbiAgICAgICAgY2FjaGU6IHtcbiAgICAgICAgICAvLyBuZWVkIHRvIGxvb2tzIGF0IHRoZSBmcm9udGVuZFdhdGNoLCBkbyB3ZSBuZWVkIGl0P1xuICAgICAgICAgIGZyb250ZW5kV2F0Y2g6IGZhbHNlLFxuICAgICAgICAgIGJhY2tlbmRXYXRjaDogZmFsc2UsXG4gICAgICAgICAgZXhpc3RpbmdTZWNyZXQ6IG9wdGlvbnMuZXhpc3RpbmdTZWNyZXQgPz8gdW5kZWZpbmVkLFxuICAgICAgICB9LFxuICAgICAgICB2Y2xUZW1wbGF0ZTogdmFybmlzaFZjbCxcbiAgICAgICAgZXh0cmFFbnZWYXJzOiBbXG4gICAgICAgICAgeyBuYW1lOiAnQkFDS0VORF9TRVJWSUNFX05BTUUnLCB2YWx1ZTogb3B0aW9ucy5wbG9uZS5iYWNrZW5kU2VydmljZU5hbWUgfSxcbiAgICAgICAgICB7IG5hbWU6ICdCQUNLRU5EX1NFUlZJQ0VfUE9SVCcsIHZhbHVlOiAnODA4MCcgfSxcbiAgICAgICAgICB7IG5hbWU6ICdCQUNLRU5EX1NJVEVfSUQnLCB2YWx1ZTogb3B0aW9ucy5wbG9uZS5zaXRlSWQgfSxcbiAgICAgICAgICB7IG5hbWU6ICdGUk9OVEVORF9TRVJWSUNFX05BTUUnLCB2YWx1ZTogb3B0aW9ucy5wbG9uZS5mcm9udGVuZFNlcnZpY2VOYW1lIH0sXG4gICAgICAgICAgeyBuYW1lOiAnRlJPTlRFTkRfU0VSVklDRV9QT1JUJywgdmFsdWU6ICczMDAwJyB9LFxuICAgICAgICBdLFxuICAgICAgICAvLyBzZWUgaHR0cHM6Ly9naXRodWIuY29tL21pdHR3YWxkL2t1YmUtaHR0cGNhY2hlL2lzc3Vlcy8yNTNcbiAgICAgICAgbm9kZVNlbGVjdG9yOiB7XG4gICAgICAgICAgJ2t1YmVybmV0ZXMuaW8vYXJjaCc6ICdhbWQ2NCcsXG4gICAgICAgIH0sXG4gICAgICAgIHJlc291cmNlczoge1xuICAgICAgICAgIGxpbWl0czoge1xuICAgICAgICAgICAgY3B1OiBvcHRpb25zLmxpbWl0Q3B1IHx8ICc1MDBtJyxcbiAgICAgICAgICAgIG1lbW9yeTogb3B0aW9ucy5saW1pdE1lbW9yeSB8fCAnNTAwTWknLFxuICAgICAgICAgIH0sXG4gICAgICAgICAgcmVxdWVzdHM6IHtcbiAgICAgICAgICAgIGNwdTogb3B0aW9ucy5yZXF1ZXN0Q3B1IHx8ICcxMDBtJyxcbiAgICAgICAgICAgIG1lbW9yeTogb3B0aW9ucy5yZXF1ZXN0TWVtb3J5IHx8ICcxMDBNaScsXG4gICAgICAgICAgfSxcbiAgICAgICAgfSxcbiAgICAgICAgcmJhYzoge1xuICAgICAgICAgIGVuYWJsZWQ6IGZhbHNlLFxuICAgICAgICB9LFxuICAgICAgICBleHBvcnRlcjoge1xuICAgICAgICAgIGVuYWJsZWQ6IG9wdGlvbnMuZXhwb3J0ZXJFbmFibGVkID8/IHRydWUsXG4gICAgICAgICAgcmVzb3VyY2VzOiB7XG4gICAgICAgICAgICBsaW1pdHM6IHtcbiAgICAgICAgICAgICAgY3B1OiAnMTAwbScsXG4gICAgICAgICAgICAgIG1lbW9yeTogJzEwME1pJyxcbiAgICAgICAgICAgIH0sXG4gICAgICAgICAgICByZXF1ZXN0czoge1xuICAgICAgICAgICAgICBjcHU6ICcxMG0nLFxuICAgICAgICAgICAgICBtZW1vcnk6ICc1ME1pJyxcbiAgICAgICAgICAgIH0sXG4gICAgICAgICAgfSxcbiAgICAgICAgfSxcbiAgICAgICAgc2VydmljZU1vbml0b3I6IHtcbiAgICAgICAgICBlbmFibGVkOiBvcHRpb25zLnNlcnZpY2Vtb25pdG9yIHx8IGZhbHNlLFxuICAgICAgICAgIHNjcmFwZVNpZ25hbGxlcjogb3B0aW9ucy5zZXJ2aWNlbW9uaXRvciB8fCBmYWxzZSxcbiAgICAgICAgfSxcbiAgICAgIH0sXG4gICAgfSk7XG4gICAgY29uc3QgaHR0cGNhY2hlU2VydmljZSA9IGh0dHBjYWNoZS5hcGlPYmplY3RzLmZpbmQoKGNvbnN0cnVjdCkgPT4ge1xuICAgICAgaWYgKChjb25zdHJ1Y3Qua2luZCA9PT0gJ1NlcnZpY2UnKSAmJiAoY29uc3RydWN0Lm1ldGFkYXRhLm5hbWU/LmVuZHNXaXRoKCdrdWJlLWh0dHBjYWNoZScpKSkge1xuICAgICAgICByZXR1cm4gY29uc3RydWN0Lm5hbWU7XG4gICAgICB9XG4gICAgICByZXR1cm4gdW5kZWZpbmVkO1xuICAgIH0pO1xuICAgIGlmIChodHRwY2FjaGVTZXJ2aWNlID09PSB1bmRlZmluZWQpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcignQ291bGQgbm90IGZpbmQgaHR0cGNhY2hlIHNlcnZpY2UnKTtcbiAgICB9XG4gICAgdGhpcy5odHRwY2FjaGVTZXJ2aWNlTmFtZSA9IGh0dHBjYWNoZVNlcnZpY2UubmFtZTtcbiAgfVxufSJdfQ==