> For the complete documentation index, see [llms.txt](https://jihoony.gitbook.io/developers-notes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jihoony.gitbook.io/developers-notes/devops/cloud/aws/diagram-as-code-for-aws-architecture..md).

# Diagram-as-code for AWS architecture.

### Diagram-as-code

This command line interface (CLI) tool enables drawing infrastructure diagrams for Amazon Web Services through YAML code. It facilitates diagram-as-code without relying on image libraries.

The CLI tool promotes code reuse, testing, integration, and automating the diagramming process. It allows managing diagrams with Git by writing human-readable YAML.

(generated from example of NAT Gateway)

### Features

* **Compliant with AWS architecture guidelines**\
  Easily generate diagrams that follow [AWS diagram guidelines](https://aws.amazon.com/architecture/icons).
* **Flexible**\
  Automatically adjust the position and size of groups.
* **Lightweight & CI/CD-friendly**\
  Start quickly on a container; no dependency on headless browser or GUI.
* **Integrate with your Infrastructure as Code**\
  Generate diagrams to align with your IaC code without managing diagrams manually.
* **As a drawing library**\
  Use as Golang Library and integrate with other IaC tools, AI, or drawing GUI tools.
* **Extensible**\
  Add definition files to create non-AWS diagrams as well.

### Getting started

#### for macOS user

In preparing.

#### for Gopher

```
# go install github.com/awslabs/diagram-as-code/cmd/awsdac@latest
```

### Resource types

See doc/resource-types.md.

### Resource Link

See doc/links.md.

### Example usage

See examples templates.

### Security

See [CONTRIBUTING](about:/awslabs/diagram-as-code/blob/main/CONTRIBUTING.md#security-issue-notifications) for more information.

### License

This project is licensed under the Apache-2.0 License.

{% embed url="<https://github.com/awslabs/diagram-as-code?tab=readme-ov-file>" %}