/aws-coder-workshop-gitops

AWS Coder Workshop GitOps flow for Coder Template Admin

Primary LanguageHCLMIT LicenseMIT

AWS Coder Workshop GitOps

AWS Workshop Demo of GitOps flow for Coder Template Admin

Overview

A demonstration project showcasing GitOps workflows and best practices for Coder administration. This repo is meant to be used in conjunction with our Kubernetes Devcontainer template, which creates a Coder Workspace a Coder Admin can use for deployment and template administration. The .devcontainer specification contained in this repo will deploy a Workspace that has terraform, helm, and kubectl utilities provisioned that are commonly used by Platform Engineering teams supporting Coder.

IaC is provided as terraform scripts along with bash script templates_gitops.sh that enable Coder templates to be created and versioned within this repo using a terraform-based GitOps flow.

Prerequisites

Setup Instructions

  1. Fork or copy this repo into your own Git account
  2. Create a Workspace from the Kubernetes Devcontainer template
  3. Use the repo you forked/copied for the Repository parameter of the created Workspace

GitOps Workflow

The GitOps workflow implemented in this demo uses terraform IaC, the Coder CLI, and a supplied bash script:

  • template_versions.tf - Coder Template resource definitions
  • templates/.. - Subdirectory for Coder Template IaC source code referenced in template_versions.tf
  • From Coder Workspace, open a terminal and cd to templates
  • Initialize your Workspace terraform environment
terraform init
  • Use the Coder CLI, and login into Coder and obtain Coder Session Token
coder login $CODER_AGENT_URL
  • Create and update templates defined in template_versions.tf
./templates_gitops.sh <Coder Session Token>

Five specialized workspace templates for AWS development:

  • Linux Q Developer: AI-powered development with Amazon Q Developer CLI
  • Linux SAM: Serverless development with AWS SAM CLI on ARM64
  • Windows DCV: Windows development with NICE DCV remote desktop
  • Kubernetes with Claude Code: Cloud-native development with AI task automation
  • RAG with Claude Code: RAG application prototyping with vector database

Workshop Content

Workshop content from the AWS Modernization with Coder workshop, featuring:

  • AI-powered development with Amazon Q Developer and Claude Code
  • Hands-on exercises for AI-assisted feature development
  • Task automation workflows and best practices

Features

  • Demonstrates Coder Kubernetes Devcontainer Workspaces for Platform Engineering
  • Implements basic GitOps workflow for Coder Template administration using Coder CLI, Terraform, and Git for template change management
  • Includes comprehensive workshop content for AI-driven development workflows
  • Provides specialized templates for various AWS development scenarios
  • Other template sources available at the Coder Template Registry