azure-image-builder

bởi hashicorp

Xây dựng hình ảnh được quản lý bởi Azure và hình ảnh Azure Compute Gallery với Packer. Sử dụng khi tạo hình ảnh tùy chỉnh cho máy ảo Azure.

npx skills add https://github.com/hashicorp/agent-skills --skill azure-image-builder

Azure Image Builder

Build Azure managed images and Azure Compute Gallery images using Packer's azure-arm builder.

Reference: Azure ARM Builder

Note: Building Azure images incurs costs (compute, storage, data transfer). Builds typically take 15-45 minutes depending on provisioning and OS.

Basic Managed Image

packer {
  required_plugins {
    azure = {
      source  = "github.com/hashicorp/azure"
      version = "~> 2.0"
    }
  }
}

variable "client_id" {
  type      = string
  sensitive = true
}

variable "client_secret" {
  type      = string
  sensitive = true
}

variable "subscription_id" {
  type = string
}

variable "tenant_id" {
  type = string
}

variable "resource_group" {
  type    = string
  default = "packer-images-rg"
}

locals {
  timestamp = regex_replace(timestamp(), "[- TZ:]", "")
}

source "azure-arm" "ubuntu" {
  client_id       = var.client_id
  client_secret   = var.client_secret
  subscription_id = var.subscription_id
  tenant_id       = var.tenant_id

  managed_image_resource_group_name = var.resource_group
  managed_image_name                = "my-app-${local.timestamp}"

  os_type         = "Linux"
  image_publisher = "Canonical"
  image_offer     = "0001-com-ubuntu-server-jammy"
  image_sku       = "22_04-lts-gen2"

  location = "East US"
  vm_size  = "Standard_B2s"

  azure_tags = {
    Name      = "my-app"
    BuildDate = local.timestamp
  }
}

build {
  sources = ["source.azure-arm.ubuntu"]

  provisioner "shell" {
    inline = [
      "sudo apt-get update",
      "sudo apt-get upgrade -y",
    ]
  }
}

Azure Compute Gallery

source "azure-arm" "ubuntu" {
  client_id       = var.client_id
  client_secret   = var.client_secret
  subscription_id = var.subscription_id
  tenant_id       = var.tenant_id

  os_type         = "Linux"
  image_publisher = "Canonical"
  image_offer     = "0001-com-ubuntu-server-jammy"
  image_sku       = "22_04-lts-gen2"

  location = "East US"
  vm_size  = "Standard_B2s"

  shared_image_gallery_destination {
    resource_group       = "gallery-rg"
    gallery_name         = "myImageGallery"
    image_name           = "ubuntu-webapp"
    image_version        = "1.0.${formatdate("YYYYMMDD", timestamp())}"
    replication_regions  = ["East US", "West US 2"]
    storage_account_type = "Standard_LRS"
  }
}

Authentication

Service Principal

# Create service principal
az ad sp create-for-rbac \
  --name "packer-sp" \
  --role Contributor \
  --scopes /subscriptions/<subscription-id>

# Set environment variables
export ARM_CLIENT_ID="<client-id>"
export ARM_CLIENT_SECRET="<client-secret>"
export ARM_SUBSCRIPTION_ID="<subscription-id>"
export ARM_TENANT_ID="<tenant-id>"

Managed Identity

source "azure-arm" "ubuntu" {
  use_azure_cli_auth = true
  subscription_id    = var.subscription_id
  # ... rest of configuration
}

Build Commands

# Set authentication
export ARM_CLIENT_ID="your-client-id"
export ARM_CLIENT_SECRET="your-client-secret"
export ARM_SUBSCRIPTION_ID="your-subscription-id"
export ARM_TENANT_ID="your-tenant-id"

# Initialize plugins
packer init .

# Validate template
packer validate .

# Build image
packer build .

Common Issues

Authentication Failed

  • Verify service principal credentials
  • Ensure Contributor role on resource group
  • Check subscription and tenant IDs

Compute Gallery Version Exists

  • Image versions are immutable
  • Use unique version numbers with date/build number
  • Cannot overwrite existing versions

Timeout During Provisioning

  • Check network connectivity from build VM
  • Verify NSG rules allow required traffic
  • Increase timeout if needed

References

Thêm skills từ hashicorp

provider-framework-migration
hashicorp
Chuyển đổi tài nguyên và nguồn dữ liệu của provider Terraform từ Plugin SDKv2 sang Plugin Framework: kết hợp cả hai plugin trong một provider (terraform-plugin-mux,…
provider-configuration
hashicorp
Triển khai cấu hình và xác thực nhà cung cấp Terraform với Plugin Framework: lược đồ nhà cung cấp cho thông tin xác thực (thuộc tính Tùy chọn + Nhạy cảm),…
provider-ephemeral-resources
hashicorp
Triển khai tài nguyên tạm thời (ephemeral resources) của Terraform provider với Plugin Framework: vòng đời Open/Renew/Close, thiết kế schema tạm thời, đăng ký qua…
terraform-test
hashicorp
Hướng dẫn toàn diện để viết và chạy các bài kiểm tra Terraform với xác nhận, giả lập và xác thực module. Viết tệp kiểm tra bằng cú pháp .tftest.hcl với các khối run thực thi ở chế độ plan hoặc apply, hỗ trợ thực thi tuần tự và song song với tùy chọn cách ly trạng thái. Xác nhận điều kiện trên các thuộc tính tài nguyên, đầu ra và nguồn dữ liệu; sử dụng expect_failures để xác thực rằng đầu vào không hợp lệ bị từ chối đúng cách. Mock providers (Terraform 1.7.0+) mô phỏng hành vi cơ sở hạ tầng mà không cần...
terraform-policy
hashicorp
Viết, kiểm tra hoặc chuyển đổi các tệp Terraform Policy (.policy.hcl, .policytest.hcl, Sentinel→tfpolicy). Kích hoạt: policy.hcl, policytest, convert sentinel, tfpolicy,…
terraform-search-import
hashicorp
Khám phá các tài nguyên đám mây hiện có bằng truy vấn Terraform Search và nhập hàng loạt chúng vào quản lý Terraform. Sử dụng khi đưa cơ sở hạ tầng chưa được quản lý vào...
aws-ami-builder
hashicorp
Xây dựng các Amazon Machine Images tùy chỉnh với trình xây dựng amazon-ebs của Packer. Tự động hóa việc tạo AMI từ các AMI nguồn bằng cách sử dụng các mẫu HCL với các bộ cung cấp để tùy chỉnh (script shell, tải lên tệp, quản lý cấu hình). Hỗ trợ phân phối AMI đa vùng qua ami_regions và lọc AMI nguồn linh hoạt theo tên, chủ sở hữu và loại ảo hóa. Xác thực qua biến môi trường, tệp thông tin xác thực AWS hoặc hồ sơ phiên bản IAM; bao gồm các lệnh xác thực và xây dựng cho mẫu...
tfctl
hashicorp
Tương tác với HCP Terraform / Terraform Cloud / Terraform Enterprise bằng CLI tfctl. Bao phủ toàn bộ API. Sử dụng cho MỌI HCP Terraform hoặc Terraform Cloud hoặc…