# terraform-provider-tetration

**Repository Path**: mirrors_CiscoDevNet/terraform-provider-tetration

## Basic Information

- **Project Name**: terraform-provider-tetration
- **Description**: Terraform Provider for managing Cisco Secure Workload (Tetration) resources.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-22
- **Last Updated**: 2026-02-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cisco Secure Workload (Tetration) Terraform Provider

> **Note:** this Terraform provider is now publically available on the [Terraform Registry](https://registry.terraform.io/providers/CiscoDevNet/tetration/latest).
 
Terraform Provider for managing Cisco Secure Workload (Tetration) resources.

## Usage

### Using the Terraform Registry

Create a `main.tf` file with the following content, save, and run `terraform init` from a terminal window in the same directory as `main.tf`:

```hcl
terraform {
  required_providers {
    tetration = {
      source = "CiscoDevNet/tetration"
      version = "0.1.0"
    }
  }
}

provider "tetration" {
  api_key                  = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  api_secret               = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  api_url                  = "https://tenant.tetrationpreview.com"
  disable_tls_verification = false
}


resource "tetration_filter" "filter" {
  name         = "Terraform created filter"
  query        = <<EOF
                    {
                      "type": "eq",
                      "field": "ip",
                      "value": "10.0.0.1"
                    }
          EOF
  app_scope_id = "5ed6890c497d4f55eb5c585c"
  primary      = true
  public       = false
}
```

### Building and Consuming

1. Build the plugin

```bash
make build
```

2. Copy the plugin to your terraform plugin directory, e.g.

```
mkdir ~/.terraform.d/plugins/darwin_amd64
cp terraform-provider-tetration ~/.terraform.d/plugins/darwin_amd64
```

3.Add plugin to terraform for the current module you are working on

```bash
cd /path/to/terraform/module
terraform init -plugin-dir ~/.terraform.d/plugins/darwin_amd64
```

4.Write terraform code using this provider.

```hcl
provider "tetration" {
  api_key                  = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  api_secret               = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  api_url                  = "https://tenant.tetrationpreview.com"
  disable_tls_verification = false
}

resource "tetration_filter" "filter" {
  name         = "Terraform created filter"
  query        = <<EOF
                    {
                      "type": "eq",
                      "field": "ip",
                      "value": "10.0.0.1"
                    }
          EOF
  app_scope_id = "5ed6890c497d4f55eb5c585c"
  primary      = true
  public       = false
}
```

More [example terraform modules for managing tetration resources with this provider.](./examples)

## Development

### Testing

Tests can be executed via

```bash
make test
```

When the test process is running any variable set in a top level `.env` file in this project will be available to the tests as an environment variable.

Example `.env` file

```bash
VARIABLE=value
```

This file is gitignored to prevent any sensitive material such as api keys from being published.

## Publishing

To build binaries for mac, linux(amd64), windows(x86), run

```bash
make cross-compile
```

The built binaries will be placed in the [bin directory](./bin).