jgraph / plantuml-serverless

Serverless PlantUML diagram rendering

Render PlantUML diagrams with AWS Lambda

A serverless UI + API to render PlantUML diagrams.

Drop in replacement for official PlantUML server

This can be used as a drop in replacement for scenarios where http://www.plantuml.com/plantuml is used as a rendering endpoint. You can avoid sending the diagram source to a server outside your control and use an encrypted HTTPS endpoint for the diagram traffic.

This doesn't support everything the official PlantUML server does but should be good for most intents and purposes (PNG, SVG and TXT rendering).

For example, to have Visual Studio Code PlantUML plugin render using your own serverless deployment, set the following properties in vscode for the plugin:

    "plantuml.render": "PlantUMLServer",
    "plantuml.server": "https://your-endpoint-here"

Use "plantuml.server": "https://plantuml.nitorio.us" if you'd like to try before you deploy your own.

Demo

PNG Diagram

SVG Diagram

TXT Diagram

https://plantuml.nitorio.us/txt/Kt8goYylJYrIKj2rKr1o3F1KS4yiIIrFh5IoKWZ8ALOeIirBIIrIACd8B5Oeo4dCAodDpU52KGVMw9EOcvIIgE1McfTSafcVfwI0JpU6Of09C6czhCGYlDgnwBVHrSKq80YiEJL58IKpCRqeCHVDrM0zM9oDgGqUGc0jg464hXe0

Build

• npm ci
• mvn clean package

Deploy

You can deploy with Serverless framework or AWS SAM.

This used to be available on the AWS Serverless Application Repository, but currently that's not possible because it doesn't appear to support lambda functions packaged as container images.

Serverless framework:

• Edit serverless.yml to replace custom.domains.dev and custom.domains.prod with your own domain names.
  • If you don't want a custom domain name, remove or comment out the serverless-domain-manager plugin from the plugins list and skip the sls create-cert and sls create_domain commands.
• Run sls create-cert to create an ACM certificate for your domain as configured in custom.customCertificate.
• Run sls create_domain to create an API Gateway custom domain as configured in custom.customDomain.
• Run sls deploy.

The above steps deploy the default dev stage. To deploy the prod stage, add --stage prod to each command.

AWS SAM

• Run sam-deploy.sh

The SAM deployment doesn't include custom domains currently.

JGraph deployment

• Set the region in the serverless.yml file, then deploy using sls deploy
• Ensure gateway urls are the same and matches the ones used in region CF worker
• Ensure the gateway custom domain (plant-aws.diagrams.net) API mapping is correct. Currently, it points to prod-plantuml-serverless - prod in eu-central-1 region
• You can edit the domain manually also from (API Gateway -> Custom domain names) and set the new stack name (API Mapping)