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.0

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>
   

3. Use this or similar configuration:

   terraform {
       required_providers {
           akp = {
               source = "akuity/akp"
               version = "~> 0.2"
           }
       }
   }
   
   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" "test" {
       name             = "test-cluster"
       description      = "Test Cluster 1"
       namespace        = "akuity"
       instance_id      = data.akp_instance.existing.id
       kube_config      = {
           # Configuration similar to `kubernetes` provider
       }
   }