К основному содержанию
скилл CX Codex

opentofu-migration — скилл для Claude Code

Скилл opentofu-migration для Claude Code переносит кодовую базу инфраструктуры с Terraform на OpenTofu с сохранением совместимости стейта.

MIT 346 установок ★ 1 214 обновлён 2026-05-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill opentofu-migration -a claude-code
Открыть на GitHub

Что делает opentofu-migration

Скилл автоматизирует переход на форк Terraform, обновляет команды CLI и конфигурации CI/CD конвейеров для GitHub Actions и GitLab CI. Агент настраивает реестр провайдеров и проверяет совместимость стейт-файлов.

Для работы требуется установленный Terraform версии 0.13 и выше, утилита OpenTofu CLI, а также доступ к хранилищу стейта.

Какие задачи решает

  • перенести конфигурации инфраструктуры с Terraform на OpenTofu
  • обновить CI/CD пайплайны GitHub Actions и GitLab CI под OpenTofu
  • настроить реестр провайдеров и файлы блокировок
  • проверить совместимость файлов состояния

Примеры запросов агенту

  • Перенеси текущий проект с Terraform на OpenTofu
  • Обнови конфигурацию CI/CD для работы с OpenTofu
  • Проверь совместимость стейта с OpenTofu

Как установить opentofu-migration

1Через Skills CLI (Vercel)

npx skills add BagelHole/DevOps-Security-Agent-Skills --skill opentofu-migration -a claude-code

2Вручную: положить файлы

~/.claude/skills/opentofu-migration/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/opentofu-migration/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об opentofu-migration

Как установить opentofu-migration в Claude Code?

Выполните команду npx skills add BagelHole/DevOps-Security-Agent-Skills --skill opentofu-migration -a claude-code, а затем обратитесь к файлу ~/.claude/skills/opentofu-migration/SKILL.md.

Что делает opentofu-migration?

Скилл помогает перенести инфраструктурный код на OpenTofu, заменяет команды, обновляет реестр провайдеров и настраивает автоматизацию в CI/CD.

Что нужно для работы opentofu-migration?

Нужен существующий проект на Terraform версии 0.13 и выше, установленный OpenTofu CLI и доступ к бэкенду состояния.

Исходный текст

SKILL.md · MIT
---
name: opentofu-migration
description: Migrate from Terraform to OpenTofu with state compatibility, provider registry setup, and CI/CD pipeline updates. Use when adopting the open-source Terraform fork or evaluating license-free IaC.
license: MIT
metadata:
  author: devops-skills
  version: "1.0"
---

# OpenTofu Migration

Migrate infrastructure-as-code from HashiCorp Terraform to the open-source OpenTofu fork.

## When to Use This Skill

Use this skill when:
- Migrating from Terraform to OpenTofu for licensing reasons
- Setting up a new IaC project and evaluating OpenTofu vs Terraform
- Updating CI/CD pipelines to use OpenTofu
- Configuring the OpenTofu provider registry

## Prerequisites

- Existing Terraform codebase (0.13+)
- OpenTofu CLI installed
- State backend access (S3, GCS, Azure Blob, etc.)

## Install OpenTofu

```bash
# macOS
brew install opentofu

# Linux (Debian/Ubuntu)
curl --proto '=https' --tlsv1.2 -fsSL https://get.opentofu.org/install-opentofu.sh \
  -o install-opentofu.sh
chmod +x install-opentofu.sh
./install-opentofu.sh --install-method deb
rm install-opentofu.sh

# Linux (RPM)
./install-opentofu.sh --install-method rpm

# Docker
docker run --rm -v $(pwd):/workspace -w /workspace \
  ghcr.io/opentofu/opentofu:latest init

# Verify installation
tofu --version
```

## Migration Checklist

### 1. Verify Compatibility

```bash
# OpenTofu reads Terraform state files directly — no migration needed
# Check your Terraform version (must be <= 1.6.x for full compat)
terraform version

# Run plan with OpenTofu against existing state
tofu init
tofu plan
```

### 2. Replace CLI Commands

| Terraform | OpenTofu |
|-----------|----------|
| `terraform init` | `tofu init` |
| `terraform plan` | `tofu plan` |
| `terraform apply` | `tofu apply` |
| `terraform destroy` | `tofu destroy` |
| `terraform fmt` | `tofu fmt` |
| `terraform validate` | `tofu validate` |
| `terraform state` | `tofu state` |
| `terraform import` | `tofu import` |

### 3. Update Provider Lock File

```bash
# Remove Terraform lock and regenerate for OpenTofu
rm .terraform.lock.hcl
tofu init -upgrade

# Verify providers resolve correctly
tofu providers
```

### 4. Update State Backend

State files are compatible — no migration needed. Just verify:

```hcl
# backend.tf — works identically with OpenTofu
terraform {
  backend "s3" {
    bucket         = "mycompany-tfstate"
    key            = "prod/infrastructure.tfstate"
    region         = "us-east-1"
    dynamodb_table = "terraform-locks"
    encrypt        = true
  }
}
```

```bash
# Verify state access
tofu init
tofu state list
```

### 5. Provider Registry

OpenTofu uses its own registry but mirrors most Terraform providers:

```hcl
# versions.tf
terraform {
  required_version = ">= 1.6.0"

  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
    kubernetes = {
      source  = "hashicorp/kubernetes"
      version = "~> 2.25"
    }
    # OpenTofu-specific providers
    random = {
      source  = "hashicorp/random"
      version = "~> 3.6"
    }
  }
}
```

## OpenTofu-Specific Features

### State Encryption (Not in Terraform)

```hcl
# OpenTofu supports native state encryption
terraform {
  encryption {
    key_provider "pbkdf2" "my_key" {
      passphrase = var.state_passphrase
    }
    method "aes_gcm" "encrypt" {
      keys = key_provider.pbkdf2.my_key
    }
    state {
      method   = method.aes_gcm.encrypt
      enforced = true
    }
    plan {
      method   = method.aes_gcm.encrypt
      enforced = true
    }
  }
}
```

### Early Variable/Local Evaluation

```hcl
# OpenTofu allows variables in backend config and module sources
terraform {
  backend "s3" {
    bucket = var.state_bucket  # Works in OpenTofu, not Terraform
    key    = "${var.project}/terraform.tfstate"
    region = var.aws_region
  }
}
```

## CI/CD Pipeline Updates

### GitHub Actions

```yaml
# .github/workflows/tofu.yml
name: OpenTofu
on:
  pull_request:
    paths: ["infra/**"]
  push:
    branches: [main]
    paths: ["infra/**"]

permissions:
  id-token: write
  contents: read
  pull-requests: write

jobs:
  plan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup OpenTofu
        uses: opentofu/setup-opentofu@v1
        with:
          tofu_version: "1.8.0"

      - name: Configure AWS credentials
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: arn:aws:iam::123456789:role/tofu-deploy
          aws-region: us-east-1

      - name: Init
        run: tofu init
        working-directory: infra/

      - name: Plan
        id: plan
        run: tofu plan -no-color -out=tfplan
        working-directory: infra/

      - name: Comment PR with plan
        if: github.event_name == 'pull_request'
        uses: actions/github-script@v7
        with:
          script: |
            const output = `#### OpenTofu Plan
            \`\`\`
            ${{ steps.plan.outputs.stdout }}
            \`\`\``;
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: output.substring(0, 65536)
            });

  apply:
    needs: plan
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    environment: production
    steps:
      - uses: actions/checkout@v4
      - uses: opentofu/setup-opentofu@v1
      - uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: arn:aws:iam::123456789:role/tofu-deploy
          aws-region: us-east-1
      - run: tofu init && tofu apply -auto-approve
        working-directory: infra/
```

### GitLab CI

```yaml
# .gitlab-ci.yml
stages: [validate, plan, apply]

variables:
  TOFU_VERSION: "1.8.0"

.tofu-base:
  image: ghcr.io/opentofu/opentofu:${TOFU_VERSION}
  before_script:
    - tofu init

validate:
  extends: .tofu-base
  stage: validate
  script:
    - tofu fmt -check
    - tofu validate

plan:
  extends: .tofu-base
  stage: plan
  script:
    - tofu plan -out=tfplan
  artifacts:
    paths: [tfplan]

apply:
  extends: .tofu-base
  stage: apply
  script:
    - tofu apply tfplan
  when: manual
  only: [main]
  dependencies: [plan]
```

## Coexistence Strategy

If you need both tools during migration:

```bash
# Use aliases to avoid conflicts
alias tf="terraform"
alias tofu="tofu"

# Or use direnv per-project
# .envrc
export PATH="/opt/opentofu/bin:$PATH"

# Wrapper script for gradual migration
#!/bin/bash
if [ -f ".use-opentofu" ]; then
    exec tofu "$@"
else
    exec terraform "$@"
fi
```

## Troubleshooting

| Issue | Solution |
|-------|---------|
| Provider not found | Run `tofu init -upgrade`, check registry.opentofu.org |
| State lock conflict | Same as Terraform — check DynamoDB/blob lease |
| Version constraint error | Update `required_version` to `>= 1.6.0` |
| Backend migration | State is compatible — just run `tofu init` |
| Missing provider credentials | Same env vars work (`AWS_*`, `GOOGLE_*`, `ARM_*`) |

## Related Skills

- [terraform-aws](../../cloud-aws/terraform-aws/) — AWS IaC patterns (works with both)
- [terraform-azure](../../cloud-azure/terraform-azure/) — Azure IaC patterns
- [terraform-gcp](../../cloud-gcp/terraform-gcp/) — GCP IaC patterns
- [policy-as-code](../../../compliance/governance/policy-as-code/) — OPA policy checks for IaC

© devops-skills · MIT · BagelHole/DevOps-Security-Agent-Skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
opentofu oakoss Помогает писать и проверять конфигурации OpenTofu и Pulumi. Помогает управлять инфраструктурой, состоянием и окружениями из кода. CX Codex +1 153установок terraform-skill Anton Babenko Диагностирует риски и управляет кодом Terraform и OpenTofu в ассистенте. Помогает при рефакторинге модулей, миграциях стейта и настройке безопасного пайплайна. CX Codex +1 8 200установок terragrunt-generator akin-ozer Скилл terragrunt-generator создаёт конфигурации Terragrunt по актуальным стандартам HCL. Пригодится при настройке многосредовой инфраструктуры для dev, staging и prod. CX Codex +1 1 300установок terraform-iac-expert curiositech Скилл terraform-iac-expert для Claude Code работает с Terraform-инфраструктурой: модулями, состоянием, мультисредами, бэкендами и секретами. Разбирает разросшийся проект и сломанный план. CX Codex +1 179установок terraform-specialist davila7 Скилл terraform-specialist для Claude Code, который проектирует модули Terraform и OpenTofu, управляет состоянием и автоматизирует развёртывание инфраструктуры через CI. CX Codex +1 70установок glab-opentofu vince-winkintel Скилл glab-opentofu для Claude Code помогает управлять состояниями OpenTofu и Terraform в GitLab. Агент подключает его при настройке backend или работе с инфраструктурой как кодом. CX Codex +1 119установок

Из того же набора138

Весь набор →
vllm-server Развёртывает серверы инференса vLLM с непрерывным батчингом и тензорным параллелизмом. Запускает открытые модели через API, совместимый с OpenAI. CX Codex +1 350установок azure-monitor-audit Скилл azure-monitor-audit настраивает аудит подписки Azure через Monitor, Log Analytics и журнал действий. Помогает собирать логи для SOC 2, HIPAA, PCI DSS и ISO 27001. CX Codex +1 349установок datadog Настраивает агент Datadog, сбор логов, APM-трейсинг и метрики для сервисов и баз данных. Пригодится при развёртывании единого мониторинга инфраструктуры. CX Codex +1 347установок firebase-app-platform Скилл firebase-app-platform для Claude Code подключает знания о Firebase: агент пишет правила безопасности, настраивает триггеры и деплоит бэкенды через firebase deploy. CX Codex +1 347установок openclaw-local-mac-mini Скилл openclaw-local-mac-mini для Claude Code помогает развернуть OpenClaw локально и настроить Mac mini для постоянной работы агента. Включается при настройке Docker Compose, сети и служб macOS. CX Codex +1 346установок vector-database-ops Скилл vector-database-ops для Claude Code, Codex, Cursor и других платформ: развёртывание и настройка Qdrant, Weaviate, pgvector и Pinecone. Покрывает коллекции, индексы, бэкапы и производительность для RAG и семантического поиска в проде. CX Codex +1 345установок multi-tenant-llm-hosting Скилл multi-tenant-llm-hosting помогает спроектировать общий хостинг LLM для нескольких команд или клиентов: изоляция тенантов, квоты, биллинг и защита от шумных соседей. CX Codex +1 344установок ai-inference-service-mesh Скилл ai-inference-service-mesh для Claude Code, Codex, Cursor и других платформ управляет трафиком AI-инференса через Istio или Linkerd: mTLS, canary-релизы, политики доступа и circuit breaker. CX Codex +1 344установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой