ai-workspace-infra/iac_modules
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,583 Commits 3 Branches 2 Tags 21 MiB
HCL 43.3%
Python 37.2%
Shell 13.7%
Makefile 3.2%
Dockerfile 1.7%
Other 0.9%
main
Go to file
Haitao Pan 4d7336c26d
docs: add GitHub branch model strategy + v1.1.5 release-prep record (#214) 
- tldr-github-branch-model.md: 两级分支保护、release/* 发布门禁、§8 应急流程
- release-v1.1.5-preparation.md: 本轮 7 仓发布前准备完整记录

Co-authored-by: Haitao Pan <manbuzhe2009@qq.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 12:45:21 +08:00
.github ci: add release/* branch source validation workflow (#212) 2026-06-28 12:12:39 +08:00
docs docs: add GitHub branch model strategy + v1.1.5 release-prep record (#214) 2026-06-28 12:45:21 +08:00
example refactor: reorganize IaC modules and examples structure 2025-12-22 13:40:01 +08:00
scripts Standardize cloud bootstrap destroy process 2026-01-02 02:14:20 +00:00
skills refactor(vultr-vps): split declaration / shared templates / shared scripts 2026-06-23 21:21:45 +08:00
terraform-hcl-standard fix(terraform): source backend region from environment 2026-06-26 18:10:27 +08:00
vpn-overlay feat(vxlan): enhance setup_sit_vxlan.sh, add overlay_diag.sh and README 2025-04-05 11:46:19 +08:00
.gitignore Update workflows 2026-01-02 11:11:11 +08:00
.gitmessage.txt feat(iac): Refactor structure and support multi-environment config loading 2025-03-29 11:09:24 +08:00
.gitmodules merged: observability, aigc_app_engine, containerd_platform, micro_service, sso_identity_provider, devops 2025-03-24 20:53:24 +08:00
LICENSE chore: add Apache License 2.0 to iac_modules. 2026-02-01 23:38:57 +08:00
README.md docs: rewrite READMEs in xworkspace-console style 2026-06-28 12:10:18 +08:00
README.zh.md docs: rewrite READMEs in xworkspace-console style 2026-06-28 12:10:18 +08:00
requirements.txt feat: add Vultr landing zone baseline 2025-09-29 18:50:37 +08:00

README.md

🇺🇸 English | 🇨🇳 中文

AI Workspace Infrastructure Modules (iac_modules)

iac_modules is the core Infrastructure-as-Code (IaC) repository for the AI Workspace ecosystem. It provides cloud-neutral, multi-cloud GitOps orchestrations, standard Terraform/Terragrunt modules, and automated deployment pipelines for establishing a resilient, scalable AI infrastructure platform.

About

  • Cloud-Neutral by Design: Consistent resource abstraction across AWS, GCP, Azure, Alibaba Cloud, and Vultr.
  • GitOps Orchestration: Automated multi-environment pipelines for bootstrap, landing zone, and account matrices.
  • VPN Overlay & Networking: Includes configurations for establishing secure vpn-overlay (WireGuard, Xray) connections.
  • Standardized HCL: A robust library of pre-configured terraform-hcl-standard modules for compute, networking, and security.

Start TLDR

Note: These modules are designed to be consumed by CI/CD pipelines (e.g., GitHub Actions) and orchestration tools rather than being run entirely manually.

Prerequisites

Ensure you have the following installed if you plan to run modules locally:

  • Terraform >= 1.5.0
  • Terragrunt >= 0.50.0
  • Cloud Provider CLIs (AWS CLI, gcloud, etc.)

Usage

  1. Multi-cloud Pipelines: Refer to the .github/workflows directory for automated matrices:
.github/workflows/iac-pipeline-mutli-cloud-bootstrap.yaml
.github/workflows/iac-pipeline-mutli-cloud-landingzone-baseline.yaml
  1. Standard Terraform Modules: Navigate to the module directory and initialize:
cd terraform-hcl-standard/
terraform init
terraform plan
  1. Setup VPN Overlay:
cd vpn-overlay/
# Follow specific instructions for wireguard or xray setup

Repository Structure

  • terraform-hcl-standard/: Core, reusable Terraform modules.
  • vpn-overlay/: Secure networking and overlay configurations.
  • .github/workflows/: GitOps pipelines and CI/CD matrices.
  • scripts/: Helper scripts for environment setup and deployment.
  • example/: Example implementations and reference architectures.

Docs / Links