terraform-provider-akp

README

Terraform Provider for Akuity Platform

With this provider you can manage Argo CD instances and clusters on Akuity Platform.

• Akuity Platform Docs
• Argo CD Docs
• Akuity Platform Portal

Requirements

• Terraform >= 1.2

Typical use case

Add a new cluster test-cluster to the existing Argo CD instance manualy-created and install the agent to the configured cluster.

1. Create an API key for your organization
   • Use Admin role for the key
2. Configure Environment variables

export AKUITY_API_KEY_ID=<key-id>
export AKUITY_API_KEY_SECRET=<key-secret>

1. Use this or similar configuration:

terraform {
  required_providers {
    akp = {
      source = "akuity/akp"
      version = "~> 0.5.0"
    }
  }
}

provider "akp" {
  org_name = "<organization-name>"
}

# Read the existing Argo CD Instance
data "akp_instance" "existing" {
  name = "manualy-created"
}

# Add cluster to the existing instance and install the agent
resource "akp_cluster" "example" {
   instance_id = data.akp_instance.example.id
   kube_config = {
      "config_path" = "test.kubeconfig"
   }
   name      = "test-cluster"
   namespace = "test"
   labels = {
      test-label = "true"
   }
   annotations = {
      test-annotation = "false"
   }
   spec = {
      namespace_scoped = true
      description      = "test-description"
      data = {
         size                  = "small"
         auto_upgrade_disabled = true
         target_version        = "0.4.0"
         kustomization         = <<EOF
  apiVersion: kustomize.config.k8s.io/v1beta1
  kind: Kustomization
  resources:
  - test.yaml
            EOF
      }
   }
}

See more examples in here.

Upgrading

• Upgrading to v0.5