Aspire.Terraform

KO | EN

gitlite — search

#javascript #python #hacktoberfest #typescript #golang #go #machine-learning #deep-learning #linux #java #awesome #cli #kubernetes #ios

Aspire.Terraform

(★ 12)

A tool to create terraform IaC based on Aspire manifest file.

Aspire.Terraform 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Aspire.Terraform

[![Quality Build](https://github.com/lolochristen/Aspire.Terraform/actions/workflows/quality.yml/badge.svg)](https://github.com/lolochristen/Aspire.Terraform/actions/workflows/quality.yml)
[![Release to NuGet](https://github.com/lolochristen/Aspire.Terraform/actions/workflows/release.yml/badge.svg)](https://github.com/lolochristen/Aspire.Terraform/actions/workflows/release.yml)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/lolochristen/Aspire.Terraform/blob/main/LICENSE)
![GitHub Tag](https://img.shields.io/github/v/tag/lolochristen/Aspire.Terraform)

Libraries for .NET Aspire to create terraform code based on templates or [Cloud Development Kit (CDK) for Terraform (CDKTF)](https://developer.hashicorp.com/terraform/cdktf).

> [!WARNING]
> **Alpha Version** is still in development - APIs may change

`Aspire.Terraform` supports template based generation as well as CDK for Terraform (`CDKTF`).

## Template based

`Aspire.Terraform` provides a set of templates that can be used to generate Terraform code for various resource types. These templates are stored in the `.\templates` folder and use [Handlebars](https://handlebarsjs.com/) syntax for dynamic content generation.

```console
dotnet add package Terraform.Aspire.Hosting
// or
dotnet add package Terraform.Aspire.Hosting.Azure
```

Add `.Azure` package for support of Azure resources.

Add the following lines to you Aspire Host:

```csharp
builder.AddTerraformTemplatePublishing()
// or
builder.AddTerraformAzureTemplatePublishing()
```

Define the location of template files either by defining it in the `appsettings.json`

```json
  "Terraform": {
    "Templates": {
      "TemplatesPath": "https://raw.githubusercontent.com/lolochristen/Aspire.Terraform/refs/heads/main/templates/container-apps/"
    } 
  } 
```

or in code

```csharp
builder.AddTerraformAzureTemplatePublishing(configureOptions: options =>
{
    options.TemplatesPath = "../my-templates";
});
```

The `./templates/container-apps` in this repository contains a base template to deploy to Azure Container Apps. Other templates or targets will eventually be added.

### Publish

To execute the publisher for terraform use the following command line from your Aspire Host project folder:

```console
dotnet run --publisher terraform --output-path terraform
```

An integration into terragrunt is also possible by using run_cmd, see `./playground/AzureContainerApps/terragrunt` for an example.

## Use of CDK for Terraform

In addition to template-based generation, `Aspire.Terraform` also supports the use of CDK for Terraform (CDKTF). This allows developers to define their infrastructure using familiar programming languages and leverage the power of the CDK ecosystem.

### Install / Setup

1. Install CDK TF from [here](https://developer.hashicorp.com/terraform/cdktf)

```console
    dotnet add package Terraform.Aspire.Hosting.Cdk
    ```

1. Create a `cdktf.json` file in your Aspire Host project folder with the following content:

```json
    {
      "language": "csharp",
      "app": "dotnet run -project [Project].csproj --publisher terraform --output-path infra",
      "projectId": "d8c23291-21cf-4f76-b40d-90cc2e384901",
      "output": "infra", 
      "terraformProviders": [
        "azure/azapi@~> 2.4"
      ],
      "context": {}
    }
    ```

1. Add the CDK publisher to your Aspire Host:

```csharp
    builder.AddTerraformCdkPublishing();
    ```

1. Define your environment and stacks

```csharp
    var terraform = builder.AddTerraformCdkEnvironment("terraform");
    var mystack = terraform.AddStack<MyStack>("mystack");

public class MyStack : TerraformStack
    {
       public MyStack(Construct scope, string id) : base(scope, id)
       {
           new TerraformOutput(this, "output1", new TerraformOutputConfig()
           {
               Value = "Hello from MyStack"
           });
       }
    }
    ```

1. Use cdktf CLI or just generate stack with '''dotnet run --publisher terraform --output-path infra''' command

Aspire.Terraform

Aspire.Terraform 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Aspire.Terraform

Aspire.Terraform 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README