Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/klothoplatform/klotho

Klotho - write AWS applications at lightning speed
https://github.com/klothoplatform/klotho

architecture aws aws-lambda azure fargate gcp kubernetes microservices pulumi serverless terraform

Last synced: about 1 month ago
JSON representation

Klotho - write AWS applications at lightning speed

Host: GitHub
URL: https://github.com/klothoplatform/klotho
Owner: klothoplatform
License: apache-2.0
Created: 2022-09-19T17:14:13.000Z (about 2 years ago)
Default Branch: main
Last Pushed: 2024-08-22T18:26:25.000Z (3 months ago)
Last Synced: 2024-09-27T18:41:44.177Z (about 1 month ago)
Topics: architecture, aws, aws-lambda, azure, fargate, gcp, kubernetes, microservices, pulumi, serverless, terraform
Language: Go
Homepage: https://klo.dev
Size: 5.8 MB
Stars: 1,119
Watchers: 11
Forks: 38
Open Issues: 170
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md

Awesome Lists containing this project

my-awesome - klothoplatform/klotho - lambda,azure,fargate,gcp,kubernetes,microservices,pulumi,serverless,terraform pushed_at:2024-08 star:1.1k fork:0.0k Klotho - write AWS applications at lightning speed (Go)

README

        


  


  

  


  Terraform/CDK alternative designed for developers

  




[![test badge](https://github.com/klothoplatform/klotho/actions/workflows/test.yaml/badge.svg)](https://github.com/klothoplatform/klotho/actions/workflows/test.yaml)

[![formatting badge](https://github.com/klothoplatform/klotho/actions/workflows/prettier.yaml/badge.svg)](https://github.com/klothoplatform/klotho/actions/workflows/prettier.yaml)

[![linter badge](https://github.com/klothoplatform/klotho/actions/workflows/lint.yaml/badge.svg)](https://github.com/klothoplatform/klotho/actions/workflows/lint.yaml)

[![govulncheck](https://github.com/CloudCompilers/klotho/actions/workflows/govulncheck.yaml/badge.svg)](https://github.com/CloudCompilers/klotho/actions/workflows/govulncheck.yaml)

[![Go Coverage](https://github.com/klothoplatform/klotho/wiki/coverage.svg)](https://raw.githack.com/wiki/klothoplatform/klotho/coverage.html)

[![Latest Release](https://img.shields.io/github/v/release/klothoplatform/klotho)](https://github.com/klothoplatform/klotho/releases)

[![License](https://img.shields.io/github/license/klothoplatform/klotho)](https://github.com/klothoplatform/klotho/blob/main/LICENSE)

## What is Klotho?

Klotho is a developer-centric cloud infra-as-code deployment tool with high level constructs. It lets you think in terms of containers, functions, APIs and databases and combining them freely.

### Example Klotho infra.py

infra.py

```python

import os

from pathlib import Path

import klotho

import klotho.aws as aws

# Create the Application instance

app = klotho.Application(

    "my-sample-app",

    project="my-project",

    environment="default",

    default_region="us-west-2",  

)

dir = Path(__file__).parent.absolute()

# Create a dynamodb instance with 2 indexed attributes

dynamodb = aws.DynamoDB(

    "my-dynamodb",

    attributes=[

        {"Name": "id", "Type": "S"},    

        {"Name": "data", "Type": "S"},  

    ],

    hash_key="id",

    range_key="data"

)

# Create a lambda function that reads in code and deploys it as a zip file

my_function = aws.Function(

    "my-function",

    handler="handler.handler",

    runtime="python3.12",

    code=str(dir),

)

# Bind the dynamodb instance to the lambda function

my_function.bind(dynamodb)

# Create an ECS container

my_container = aws.Container(

    "my-container",

    dockerfile=str(dir / "container" / "Dockerfile"),

    context=str(dir),

)

# Create a Postgres instance with plain text password

my_postgres = aws.Postgres(

    "my-postgres",

    username="admin",

    password="password123!",

    database="mydb",

)

# Bind the postgres instance to the container

my_container.bind(my_postgres)

# Create an API Gateway instance

api = aws.Api("my-api")

# Bind the lambda function to the API Gateway on the /function route

api.route(

  routes: [

    RouteArgs(path="/function", method="ANY")

  ], my_function

)

# Bind the container to the API Gateway on the /container route

api.route(

  routes: [

    RouteArgs(path="/container", method="ANY")

  ], my_container

)

```

## Getting Started

To get started with Klotho, visit our [documentation](https://klo.dev/docs-k2/) and follow the guides to quickly set up your environment.

## Example Projects

Check out some [example projects](https://github.com/klothoplatform/k2-sample-apps) built using Klotho.

## Community and Support

Join our community of developers and get involved in shaping the future of Klotho:

[![Discord](https://img.shields.io/badge/Klotho-%237289DA.svg?style=for-the-badge&logo=discord&logoColor=white)](https://klo.dev/discordurl)

## Contributing

We welcome contributions from the community. Check out our [contributing guide](https://github.com/klothoplatform/klotho/blob/main/CONTRIBUTING.md) to learn how to get involved in Klotho’s development.

## License

Klotho is licensed under the Apache 2.0 License. See the [LICENSE](https://github.com/klothoplatform/klotho/blob/main/LICENSE) file for more details.