> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# ملف الحالة State في OpenTofu: الحفظ والقفل والحماية
- URL: https://arabroot.io/articles/ملف-الحالة-state-في-opentofu-الحفظ-والقفل-والحماية/
- Published: 2026-11-05T00:34:04.000Z
- Updated: 2026-11-05T01:33:22.000Z
- Description: أين تحفظ حالة OpenTofu حتى يراها كل الفريق، وكيف تتأكد أن القفل يعمل فعلاً، وكيف تشفرها لأنها تحمل كلمات المرور بنص واضح.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, DevOps والتشغيل, DevOps وCI/CD, الاستضافة الذاتية

في مقال [أول بنية مع OpenTofu](https://arabroot.io/articles/%D8%A7%D9%88%D9%84-%D8%A8%D9%86%D9%8A%D8%A9-%D9%85%D8%B9-opentofu-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D8%A7%D8%AA-%D9%85%D8%B9-%D8%B3%D8%AC%D9%84%D8%A7%D8%AA-dns-%D9%85%D9%86-%D9%85%D9%84%D9%81-%D9%88%D8%A7%D8%AD%D8%AF/) بقي ملف الحالة `terraform.tfstate` على جهاز واحد، وكان هذا مناسباً لأن شخصاً واحداً يشغل الأوامر. ثم انضم إلى الفريق زميل ثان، فسحب المستودع من Git، وفتح فرعاً ليضيف سيرفراً، وشغل `tofu apply` من جهازه، فطلبت الأداة أن تنشئ كل شيء من البداية: الشبكة والسيرفرات وكلمة مرور قاعدة البيانات، وكأن البنية غير موجودة. والسبب أن ملف الحالة الذي يقول «هذه السيرفرات موجودة ولها هذه المعرفات» لم يدخل Git أصلاً، كما نصحنا في المقال نفسه، فجهاز الزميل لا يعرف شيئاً عما أنشأه جهازك. وفي اليوم نفسه سأل مسؤول الأمن سؤالاً لم يفكر فيه أحد: أين نسخ هذا الملف؟ وهل فيه كلمات مرور؟ ومن يستطيع أن يقرأه؟

وهذا المقال يجيب على هذه الأسئلة الثلاثة بالترتيب الذي تظهر به في أي فريق: أين تحفظ الحالة حتى يراها كل من يعمل على البنية، وكيف تمنع شخصين من الكتابة عليها في اللحظة نفسها، وكيف تحميها لأنها تحمل أسراراً بنص واضح. وقد شرحنا في [مصطلحات البنية كشيفرة IaC](https://arabroot.io/articles/%D8%A7%D9%84%D8%A8%D9%86%D9%8A%D8%A9-%D9%83%D8%B4%D9%8A%D9%81%D8%B1%D8%A9-iac-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/) لماذا تحتاج الأداة إلى ملف حالة أصلاً، وذكرنا في [Terraform أم OpenTofu؟](https://arabroot.io/articles/terraform-%D8%A7%D9%85-opentofu-%D9%82%D8%B5%D8%A9-%D8%AA%D8%BA%D9%8A%D9%8A%D8%B1-%D8%A7%D9%84%D8%AA%D8%B1%D8%AE%D9%8A%D8%B5/) أن تشفير الحالة من الميزات التي جاء بها OpenTofu أولاً، فلن نعيد ذلك هنا، وإنما نشغل كل خيار فعلاً على جهازك دون حساب سحابي: الخلفية المحلية، ثم تخزين S3 على سيرفرك بأداتين مختلفتين، ثم PostgreSQL، ثم التشفير، ونقرأ ما تطبعه الأداة في كل خطوة، بما في ذلك مشكلتان حقيقيتان ظهرتا لنا في الطريق. وسوف نناقش في هذا المقال ما يلي:

- ما الذي يوجد في ملف الحالة فعلاً، ولماذا يوجد فيه الرقم `serial` والمعرف `lineage`، وأين وجدنا كلمة المرور.
- جهازان وحالتان محليتان، وما حدث عندما طبق الزميل الثاني.
- نقل الحالة إلى تخزين S3 على سيرفرك مع Garage، والقفل الذي لم يعمل، وكيف اكتشفنا السبب بطلب واحد.
- القفل نفسه مع SeaweedFS، وقراءة رسالة `Error acquiring the state lock`.
- ماذا يحدث إذا انقطع التطبيق في منتصفه: قفل عالق، وسيرفر لا تعرفه الحالة، وكيف أصلحناهما.
- خلفية PostgreSQL وأقفالها الاستشارية Advisory Locks، ولماذا لا تحتاج فيها إلى force-unlock.
- تشفير الحالة في OpenTofu، وما الذي يبقى مكشوفاً بعد التشفير، والنسخ الاحتياطي، وجدول اختيار الخلفية.

## ماذا يوجد في ملف الحالة State؟

ملف الحالة هو الذاكرة الوحيدة التي تملكها الأداة عن العالم الحقيقي، فعندما تكتب في الكود `docker_container.web[0]` فهذا اسم في ملفاتك فقط، ولا يعرف Docker ولا أي مزود سحابي شيئاً عنه، والذي يربط هذا الاسم بال Container الحقيقي الذي معرفه `2e55a3f61d03…` هو سطر في ملف الحالة. لذلك تحتاج الأداة إلى الحالة في كل أمر: عند الخطة لتعرف ماذا تسأل المزود عنه، وعند التطبيق لتعرف ماذا تعدل وماذا تحذف، وعند الحذف لتعرف ما الذي تملكه أصلاً. وإذا ضاع الملف فالموارد لا تضيع، وإنما تصبح الأداة لا تعرفها، فتحاول أن تنشئها من جديد، وهذا بالضبط ما سوف تراه بعد قليل.

ولنبدأ من مشروع صغير يشبه ما يحدث في أغلب الفرق، وهو نسخة مختصرة من مشروع المقال السابق: شبكة خاصة، وثلاثة سيرفرات ويب، وكلمة مرور لقاعدة البيانات تولدها الأداة مرة واحدة وتمررها إلى السيرفرات، ومورد صغير اسمه `terraform_data.slow` لا يفعل شيئاً إلا أن ينتظر عدداً من الثواني نحدده، وسوف نستخدمه لنبقي التطبيق مفتوحاً ونرى القفل من جهاز آخر:

```hcl
provider "docker" {
  host = "unix:///var/run/docker.sock"
}

variable "web_count" {
  type    = number
  default = 2
}

variable "slow_apply" {
  description = "Seconds to wait during apply (to watch the lock)"
  type        = number
  default     = 0
}

resource "docker_network" "app" {
  name = "wr-iac-app"
}

resource "docker_image" "web" {
  name         = "nginx:1.29.3-alpine"
  keep_locally = true
}

# A database password the app needs: generated once and kept in the state
resource "random_password" "db" {
  length  = 24
  special = false
}

resource "docker_container" "web" {
  count = var.web_count
  name  = "wr-iac-web-${count.index + 1}"
  image = docker_image.web.image_id
  env   = ["APP_DB_PASSWORD=${random_password.db.result}"]

  networks_advanced {
    name = docker_network.app.name
  }
}

# Holds the apply open for a while so we can see the lock from another terminal
resource "terraform_data" "slow" {
  triggers_replace = [var.slow_apply]
  provisioner "local-exec" {
    command = "sleep ${var.slow_apply}"
  }
}

output "web_names" {
  value = docker_container.web[*].name
}
```

والإصدارات مثبتة في `versions.tf` كما تعلمنا في المقال السابق: OpenTofu من سلسلة 1.13، ومزود kreuzwerker/docker بالإصدار 4.6.0، ومزود hashicorp/random بالإصدار 3.9.1\. ونشغل OpenTofu 1.13.2 من Image صغيرة بنيناها من ال Image المصغرة الرسمية، كما شرحنا في المقال السابق، ونعرف أمراً قصيراً يشغلها على المجلد الحالي، مع تمرير متغيرات البيئة التي سوف نحتاجها للخلفيات:

```bash
docker build -q -f Dockerfile.tofu -t wr-iac-tofu:1.13.2 .
docker network create wr-iac-net
alias tofu='docker run --rm -i --network wr-iac-net \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v "$PWD:/work" -w /work \
  -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e PG_CONN_STR -e TF_VAR_state_passphrase \
  wr-iac-tofu:1.13.2'
tofu init
echo 'web_count = 3' > terraform.tfvars
tofu apply -auto-approve
```

بعد أول تطبيق أصبح في المجلد ملف `terraform.tfstate` بحجم 12995 بايت، وبعد التطبيق الثاني الذي رفع عدد السيرفرات إلى ثلاثة أصبح بجانبه ملف آخر:

```text
-rw-r--r-- 1 wajdy 197609 17194 Nov  5 02:49 terraform.tfstate
-rw-r--r-- 1 wajdy 197609 12995 Nov  5 02:49 terraform.tfstate.backup
terraform.tfstate:  "serial": 2,
terraform.tfstate:  "lineage": "d3dab5bc-6286-af9b-e338-80015d251690",
terraform.tfstate.backup:  "serial": 1,
terraform.tfstate.backup:  "lineage": "d3dab5bc-6286-af9b-e338-80015d251690",
```

في المخرج أعلاه لاحظ التالي:

- الملف `terraform.tfstate.backup` هو الحالة كما كانت قبل آخر تطبيق، والخلفية المحلية Local Backend تكتبه تلقائياً في كل مرة، كما في [وثائق الخلفية المحلية](https://opentofu.org/docs/language/settings/backends/local/?ref=arabroot.io)، أي أن عندك نسخة واحدة سابقة فقط، وليس تاريخاً كاملاً.
- الرقم `serial` يزيد مع كل كتابة للحالة، فكان 1 وأصبح 2\. والأداة تستخدمه لتعرف أي نسخة أحدث، فإذا حاولت أن ترفع حالة رقمها أقل من الموجود في الخلفية رفضت الأداة، لأن هذا يعني غالباً أنك تكتب فوق عمل غيرك بنسخة قديمة.
- المعرف `lineage` ثابت في النسختين، وهو رقم عشوائي يولد عند إنشاء الحالة أول مرة، ويبقى معها طوال حياتها، ومعناه «هذه الحالة تنتمي إلى هذا المشروع». فإذا حاول أحد أن يرفع حالة مشروع آخر مكان حالتك، حتى لو كان رقمها أكبر، رفضت الأداة لأن السلالة مختلفة.

ثم بحثنا في الملف عن كلمة المرور التي ولدتها الأداة:

```text
375:            "result": "C5MTQiXDD3syLR4FuXZDmbdJ",
389:                "value": "result"
"APP_DB_PASSWORD=C5MTQiXDD3syLR4FuXZDmbdJ"
```

كلمة المرور موجودة بنص واضح في مكانين: في خاصية `result` لمورد `random_password`، وفي متغيرات البيئة لكل Container. وهذا ليس خطأ في المزود، وإنما هو طبيعة الحالة: الأداة تحفظ كل خصائص كل مورد كما أعادها المزود، لأنها تحتاج أن تقارنها في الخطة التالية، وتقول [وثائق البيانات الحساسة في الحالة](https://opentofu.org/docs/language/state/sensitive-data/?ref=arabroot.io) ذلك صراحة: الحالة قد تحتوي على بيانات حساسة، مثل كلمات المرور الأولى لقواعد البيانات والمفاتيح. ولاحظ أن الأمر `tofu state show random_password.db` يطبع `result = (sensitive value)`، أي أن الإخفاء يحدث على الشاشة فقط، أما الملف نفسه فيقرؤه أي شخص أو أي برنامج يصل إليه.

![أجزاء ملف الحالة terraform.tfstate: في الأعلى version 4 وterraform_version 1.13.2 وserial الذي يزيد مع كل كتابة وlineage الثابت لكل مشروع، ثم outputs، ثم resources وفيها كل مورد مع المعرف الذي أعطاه المزود، مثل docker_container.web[0] مع المعرف 2e55a3f61d03، وتحتها خاصية result لمورد random_password بنص واضح مع متغير APP_DB_PASSWORD داخل env، وبجانب الملف terraform.tfstate.backup الذي يحمل serial 1](https://arabroot.io/content/images/2026/11/tofu-state-01-anatomy.webp)

الحالة خريطة بين أسماء الكود ومعرفات المزود، وفيها كل الخصائص بنص واضح، ومنها الأسرار

إذاً عندنا ثلاثة متطلبات لأي مكان نحفظ فيه الحالة: أن يكون مشتركاً يصل إليه كل من يطبق، وأن يمنع كتابتين في اللحظة نفسها، وأن يحمي محتواه من القراءة. والخلفية المحلية لا تحقق إلا جزءاً من الثاني، ولا تحقق الأول ولا الثالث، وهذا ما سوف نراه الآن.

## جهازان وحالتان: ماذا يحدث مع Local Backend؟

لنمثل الزميل الثاني بمجلد آخر اسمه `laptop-b`، ونسخنا إليه ما يوجد في Git فقط: `main.tf` و`versions.tf` و`terraform.tfvars` وملف القفل، دون ملف الحالة لأنه في `.gitignore`، ثم شغلنا `init` وطلبنا الخطة:

```text
  # docker_container.web[0] will be created
  # docker_container.web[1] will be created
  # docker_container.web[2] will be created
  # docker_image.web will be created
  # docker_network.app will be created
  # random_password.db will be created
  # terraform_data.slow will be created
Plan: 7 to add, 0 to change, 0 to destroy.
```

الخطة تريد أن تنشئ سبعة موارد، وكلها موجودة فعلاً وتعمل. وهذه الخطة صحيحة تماماً من وجهة نظر الأداة، فهي لا ترى في حالتها الفارغة أي مورد، والكود يطلب سبعة، إذاً الفرق سبعة. والمراجع الذي يقرأ هذه الخطة في طلب دمج قد لا ينتبه، لأن «إضافة» تبدو آمنة دائماً. ثم طبقها الزميل:

```text
random_password.db: Creating...
random_password.db: Creation complete after 0s [id=none]
docker_image.web: Creation complete after 3s [id=sha256:b3c656d55d7ad751196f21b7fd2e8d4da9cb430e32f646adcf92441b72f82b14nginx:1.29.3-alpine]

Error: Unable to create network: Error response from daemon: network with name wr-iac-app already exists

  with docker_network.app,
  on main.tf line 16, in resource "docker_network" "app":
  16: resource "docker_network" "app" {
```

في المخرج أعلاه لاحظ التالي:

- الذي أوقف الكارثة هنا هو Docker وليس OpenTofu، لأن Docker لا يقبل شبكتين بالاسم نفسه. وعند مزود سحابي يقبل سيرفرين بالاسم نفسه، وأغلبهم يقبل، كان التطبيق سينجح وتصبح عندك ستة سيرفرات بدلاً من ثلاثة، تدفع ثمنها كلها، ونصفها لا يعرفه أحد.
- مورد `random_password.db` أنشئ بنجاح قبل الخطأ، أي أن حالة الزميل الآن فيها كلمة مرور جديدة مختلفة عن التي تعمل بها السيرفرات. ولو نجح التطبيق لكانت السيرفرات الجديدة تعمل بكلمة مرور لا تعرفها قاعدة البيانات.
- التطبيق توقف في منتصفه وترك حالة جزئية على جهاز الزميل فيها ثلاثة موارد، فالأداة لا تتراجع عما أنشأته قبل الخطأ، وإنما تحفظه في الحالة وتتوقف.

والحل الذي يخطر للناس أولاً هو أن يضعوا ملف الحالة في Git، وهذا الحل لا ينصح به إطلاقاً لثلاثة أسباب: الملف فيه أسرار بنص واضح كما رأينا، فتصبح كلمات المرور في تاريخ المستودع إلى الأبد، وقد شرحنا في [اكتشاف الأسرار المسربة](https://arabroot.io/articles/%D8%A7%D9%83%D8%AA%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-%D8%A7%D9%84%D9%85%D8%B3%D8%B1%D8%A8%D8%A9-%D9%85%D8%B9-gitleaks-%D9%88-trufflehog/) لماذا لا يمكن إخراج سر من التاريخ بسهولة. والسبب الثاني أن Git لا يمنع شخصين من التطبيق في اللحظة نفسها، فكل منهما يطبق على نسخته ثم يحاول أن يدفع، والذي يدفع ثانياً يحصل على تعارض Merge Conflict في ملف JSON لا يستطيع أحد أن يحله يدوياً بأمان. والسبب الثالث أن الزميل الذي نسي أن يسحب آخر نسخة قبل التطبيق يطبق على حالة قديمة، وهذا هو التطبيق على حالة قديمة Stale State الذي يحذف موارد أنشأها غيره لأنها ليست في نسخته.

![جهازان يعملان على البنية نفسها: الجهاز الأول عليه terraform.tfstate فيه سبعة موارد، والجهاز الثاني سحب الكود من Git دون الحالة فخطته 7 to add، وعند التطبيق رفض Docker الشبكة wr-iac-app لأنها موجودة، وبعد الخطأ بقيت عند الجهاز الثاني حالة جزئية فيها كلمة مرور جديدة، وتحتهما ملاحظة: عند مزود يقبل الأسماء المكررة كان الناتج ستة سيرفرات بدلاً من ثلاثة](https://arabroot.io/content/images/2026/11/tofu-state-02-two-laptops.webp)

كل جهاز بحالته المحلية يرى عالماً مختلفاً، والخطة صحيحة عند كل منهما

إذاً الحالة يجب أن تكون في مكان واحد خارج أجهزة الفريق، تقرأ منه الأداة قبل كل خطة وتكتب فيه بعد كل تطبيق، وهذا المكان يسمى الخلفية البعيدة Remote Backend. وفي OpenTofu خلفيات كثيرة، منها خلفيات لمزودات سحابية مثل S3 على AWS وGCS على Google، وخلفيات تعمل على سيرفرك مثل PostgreSQL وHTTP، وتستطيع أن تقرأ القائمة كاملة في [وثائق إعداد الخلفيات](https://opentofu.org/docs/language/settings/backends/configuration/?ref=arabroot.io). وأكثرها استخداماً على الإطلاق هي خلفية S3، والسبب أنها تعمل مع أي تخزين يتحدث بواجهة S3، وليس مع AWS فقط، وهذا ما يجعلها الخيار الأول لمن يستضيف بنيته بنفسه.

## الحالة في تخزين S3 على سيرفرك: Garage Backend

في مقال [تخزين الكائنات S3 على سيرفرك](https://arabroot.io/articles/%D8%AA%D8%AE%D8%B2%D9%8A%D9%86-%D8%A7%D9%84%D9%83%D8%A7%D8%A6%D9%86%D8%A7%D8%AA-s3-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83-%D8%A7%D9%84%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-%D9%88%D8%A7%D9%84%D8%A8%D9%86%D9%8A%D8%A9/) شغلنا Garage، وهو تخزين كائنات Object Storage مفتوح المصدر خفيف، يعمل بملف تنفيذي واحد، ويتحدث بواجهة S3، فبدأنا به لأنه الخيار الذي يختاره كثيرون لسيرفر صغير. وشغلناه بعقدة واحدة في Container على الشبكة نفسها، ثم أنشأنا مساحة التخزين Bucket ومفتاح وصول له صلاحية عليها فقط:

```bash
docker run -d --name wr-iac-garage --network wr-iac-net \
  -v "$PWD/garage/garage.toml:/etc/garage.toml:ro" \
  -v wr-iac-garage-meta:/var/lib/garage/meta -v wr-iac-garage-data:/var/lib/garage/data \
  dxflrs/garage:v2.4.1
G="docker exec wr-iac-garage /garage"
NODE=$($G status | awk '/^[0-9a-f]{16}/{print $1; exit}')
$G layout assign -z dc1 -c 1G $NODE
$G layout apply --version 1
$G bucket create tofu-state
$G key create tofu-ci
$G bucket allow --read --write --owner tofu-state --key tofu-ci
```

والمخرج الأخير يبين أن المفتاح `tofu-ci` له الصلاحيات الثلاث على هذه المساحة وحدها:

```text
==== KEYS FOR THIS BUCKET ====
Permissions  Access key                           Local aliases
RWO          GK4938f633f68ee5ee96e02fe9  tofu-ci  
```

ولاحظ أننا أنشأنا مفتاحاً خاصاً للحالة وحدها، ولم نستخدم مفتاحاً عاماً يصل إلى كل المساحات، والسبب أن من يملك هذا المفتاح يملك الحالة، ومن يملك الحالة يقرأ كل أسرار البنية، فالمفتاح نفسه أصبح سراً من الدرجة الأولى، ويجب أن يكون نطاقه أضيق ما يمكن.

ثم أضفنا إلى المشروع ملفاً اسمه `backend.tf` يقول للأداة أين تحفظ الحالة:

```hcl
terraform {
  backend "s3" {
    bucket = "tofu-state"
    key    = "shop/prod/terraform.tfstate"
    region = "garage"

    endpoints = {
      s3 = "http://wr-iac-garage:3900"
    }
    use_path_style              = true
    skip_credentials_validation = true
    skip_region_validation      = true
    skip_requesting_account_id  = true
    skip_metadata_api_check     = true

    use_lockfile = true # lock with a .tflock object next to the state
  }
}
```

في الإعداد أعلاه لاحظ التالي:

- القيمة `key` هي مسار الحالة داخل المساحة، واخترنا `shop/prod/` حتى تستطيع أن تضع حالة كل مشروع وكل بيئة في مسار مختلف داخل المساحة نفسها، وسوف نعود إلى هذا التقسيم في مقال الوحدات وتنظيم المشاريع.
- الخيارات التي تبدأ بـ `skip_` تمنع الأداة من أن تسأل خدمات AWS نفسها، مثل التحقق من المفتاح عند خدمة STS أو التحقق من اسم المنطقة Region، فهذه الخدمات غير موجودة عند Garage، وبدونها يفشل `init` وهو يحاول أن يتصل بـ AWS. والخيار `use_path_style` يجعل العنوان على شكل `http://host/bucket/key` بدلاً من أن يكون اسم المساحة جزءاً من اسم السيرفر، وأغلب التخزين المستضاف ذاتياً يحتاجه.
- لا يوجد مفتاح الوصول في الملف، فالأداة تقرؤه من متغيري البيئة `AWS_ACCESS_KEY_ID` و`AWS_SECRET_ACCESS_KEY`، لأن هذا الملف يدخل Git.
- الخيار `use_lockfile = true` هو القفل، وتقول [وثائق خلفية S3](https://opentofu.org/docs/language/settings/backends/s3/?ref=arabroot.io) إنه يكتب ملف قفل بجانب الحالة باستخدام الكتابة المشروطة Conditional Writes بالترويسة `If-None-Match`، وهذه هي الجملة التي سوف تهمنا بعد قليل.

### نقل الحالة إلى الخلفية الجديدة: init -migrate-state

عندما تغير الخلفية في مشروع له حالة، لا تنقل الملف بيدك، وإنما تطلب من الأداة أن تنقله، لأنها تقرأ الحالة من الخلفية القديمة وتكتبها في الجديدة وتتحقق منها:

```bash
tofu init -migrate-state
```

```text
Initializing the backend...
Do you want to copy existing state to the new backend?
  Pre-existing state was found while migrating the previous "local" backend to the
  newly configured "s3" backend. No existing state was found in the newly
  configured "s3" backend. Do you want to copy this state to the new "s3"
  backend? Enter "yes" to copy and "no" to start with an empty state.

  Enter a value: yes

Successfully configured the backend "s3"! OpenTofu will automatically
use this backend unless the backend configuration changes.
```

الأداة وجدت حالة في الخلفية المحلية، ولم تجد حالة في الجديدة، فسألت قبل أن تنسخ. وإذا وجدت حالة في الاثنين لسألتك أيهما تبقي، وهذا السؤال يستحق أن تقرأه بتمهل، لأن الإجابة الخاطئة تكتب حالة فوق أخرى. وبعد النقل نظرنا في المجلد فوجدنا شيئاً يجب أن تعرفه:

```text
-rw-r--r-- 1 wajdy 197609     0 Nov  5 02:57 terraform.tfstate
-rw-r--r-- 1 wajdy 197609 17194 Nov  5 02:57 terraform.tfstate.backup
```

الملف `terraform.tfstate` أصبح فارغاً، أما `terraform.tfstate.backup` فما زال كاملاً بحجم 17194 بايت، وفيه كلمة المرور. أي أن نقل الحالة إلى الخلفية المشتركة لا يحذف النسخة القديمة من جهازك، فاحذفها بيدك بعد أن تتأكد أن الخلفية الجديدة تعمل، وإلا بقيت أسرار البنية على كل جهاز طبق منه أحد قبل النقل.

ثم شغلنا `init` على جهاز الزميل بالخلفية الجديدة، فكانت الخطة كما نريد:

```text
docker_container.web[0]: Refreshing state... [id=2e55a3f61d03001a858d41169c6b09b8f466864ff924e20be71775c109939724]

No changes. Your infrastructure matches the configuration.
```

الجهازان يريان الآن الحالة نفسها، فالزميل لا يحاول أن ينشئ شيئاً موجوداً. وهنا انتهت المشكلة الأولى، وبقيت الثانية: ماذا لو طبق الاثنان في اللحظة نفسها؟

### مشكلة حقيقية: القفل الذي لم يقفل شيئاً If-None-Match

لكي نختبر القفل شغلنا من الجهاز الأول تطبيقاً يبقى مفتوحاً 40 ثانية بسبب المورد `terraform_data.slow`، وبعد 15 ثانية طلبنا الخطة من الجهاز الثاني. والمتوقع أن يرفض الجهاز الثاني لأن الحالة مقفلة، ولكن هذا ما حدث:

```text
random_password.db: Refreshing state... [id=none]
terraform_data.slow: Refreshing state... [id=35fcf600-1582-5064-d66b-ef4dd7e36be5]
docker_container.web[1]: Refreshing state... [id=da1c66dc01eb0479c348fdbaaa02e253d3d3f54facfc6021a4d088f21e297993]

No changes. Your infrastructure matches the configuration.
```

الجهاز الثاني عمل وكأن أحداً لا يطبق، وبعد أن انتهى الجهاز الأول من الانتظار طبع خطأ لم نتوقعه:

```text
terraform_data.slow: Creation complete after 40s [id=618d9e81-6be3-e1e4-a9fc-fdc15bf3f495]

Error: Error releasing the state lock

Error message: failed to retrieve s3 lock info: operation error S3:
GetObject, https response error StatusCode: 404, RequestID: , HostID: ,
NoSuchKey: Key not found
```

الجهاز الأول يحاول أن يفتح قفله فلا يجده. ولكي تفهم ما حدث يجب أن تعرف كيف يعمل هذا القفل من الداخل: عندما يبدأ أمر يكتب الحالة، تكتب الأداة كائناً اسمه `terraform.tfstate.tflock` بجانب الحالة، وترسل مع الطلب الترويسة `If-None-Match: *`، ومعناها عند S3 «اكتب هذا الكائن فقط إذا لم يكن موجوداً»، كما في [وثائق الكتابة المشروطة عند AWS](https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-writes.html?ref=arabroot.io). فإذا كان الكائن موجوداً لأن شخصاً آخر يطبق، رد التخزين بالرمز 412 Precondition Failed، فتعرف الأداة أن الحالة مقفلة وتتوقف. وعند الانتهاء تقرأ الأداة الكائن لتتأكد أنه قفلها، ثم تحذفه. وهذا يعني أن القفل كله يعتمد على شيء واحد: أن يحترم التخزين هذه الترويسة.

فاختبرنا ذلك مباشرة بطلبين من aws-cli إلى Garage، يكتب كل منهما الكائن نفسه مع الترويسة نفسها:

```bash
for i in 1 2; do
  echo "--- put #$i with If-None-Match: *"
  aws --endpoint-url http://wr-iac-garage:3900 --region garage s3api put-object \
    --bucket tofu-state --key probe.tflock --body lockprobe.txt --if-none-match '*'
  echo "exit=$?"
done
```

```text
--- put #1 with If-None-Match: *
{
    "ETag": "\"5bbf5a52328e7439ae6e719dfe712200\"",
    "ChecksumCRC64NVME": "H1SXwIjuQik=",
    "VersionId": "69d8d9300ede5126e699ff999f80534caeb94950f3b3f8cf2c631cfedc9403c6"
}
exit=0
--- put #2 with If-None-Match: *
{
    "ETag": "\"5bbf5a52328e7439ae6e719dfe712200\"",
    "ChecksumCRC64NVME": "H1SXwIjuQik=",
    "VersionId": "87b87e9f0935027aac268c0f032644ec4dc1e728d98a96c4789c3f1b21fdef4f"
}
exit=0
```

الطلب الثاني نجح مع أن الكائن موجود، أي أن Garage بالإصدار 2.4.1 يتجاهل الترويسة `If-None-Match` عند الكتابة ويكتب فوق الكائن. والآن يصبح ما حدث واضحاً: الجهاز الأول كتب قفله، ثم جاء الجهاز الثاني فكتب قفله فوقه ونجح، فظن أن الحالة له، وعمل خطته، ثم حذف القفل عند الانتهاء، فلما انتهى الجهاز الأول لم يجد قفلاً يحذفه. ولو كان الجهاز الثاني يطبق وليس يخطط فقط، لكتب الاثنان الحالة، والذي يكتب أخيراً يمسح ما كتبه الآخر، وتصبح الحالة لا تعرف موارد أنشأها الأول. والأخطر أن الأداة لم تطبع أي تحذير عند الحصول على القفل، فالخطأ ظهر فقط عند الفتح، وفي الحالة العكسية، أي إذا انتهى الجهاز الأول قبل الثاني، لن يظهر أي خطأ أصلاً.

وهذا لا يعني أن Garage تخزين سيئ، فهو يقول بوضوح في [صفحة التوافق مع S3](https://garagehq.deuxfleurs.fr/documentation/reference-manual/s3-compatibility/?ref=arabroot.io) ما الذي يدعمه وما الذي لا يدعمه، وفي الصفحة نفسها أنه لا يدعم تعدد النسخ Bucket Versioning بعد، وهذه نقطة ثانية تهمنا في الحالة كما سوف نرى في قسم النسخ الاحتياطي. وإنما الدرس أن «متوافق مع S3» لا يعني أنه يدعم كل ما تعتمد عليه أداتك، والقفل في خلفية S3 أضافته AWS نفسها إلى خدمتها في [أغسطس 2024](https://aws.amazon.com/about-aws/whats-new/2024/08/amazon-s3-conditional-writes/?ref=arabroot.io)، فكثير من التخزين المستضاف ذاتياً لم يلحق به، أو لحق به في إصدارات حديثة. لذلك قبل أن تعتمد على أي تخزين S3 للحالة، شغل الطلبين أعلاه بنفسك، فإذا نجح الثاني فلا تستخدم هذا التخزين للقفل.

![كيف يعمل قفل use_lockfile: الجهاز الأول يكتب terraform.tfstate.tflock مع If-None-Match: * فيرد التخزين 200، ثم يحاول الجهاز الثاني الكتابة نفسها، ففي SeaweedFS 4.48 يرد التخزين 412 Precondition Failed ويتوقف الجهاز الثاني، أما في Garage 2.4.1 فيرد 200 ويكتب فوق القفل، ثم يحذفه الجهاز الثاني عند الانتهاء فيفشل الأول عند الفتح بالخطأ NoSuchKey](https://arabroot.io/content/images/2026/11/tofu-state-03-lockfile.webp)

القفل في خلفية S3 كله يعتمد على أن يرفض التخزين الكتابة الثانية بالرمز 412

## القفل يعمل: SeaweedFS مع Error acquiring the state lock

فجربنا الطلبين نفسيهما على SeaweedFS بالإصدار 4.48، وهو تخزين آخر مستضاف ذاتياً قارناه في [أي تخزين S3 مستضاف ذاتياً يناسبك؟](https://arabroot.io/articles/%D8%A7%D9%8A-%D8%AA%D8%AE%D8%B2%D9%8A%D9%86-s3-%D9%85%D8%B3%D8%AA%D8%B6%D8%A7%D9%81-%D8%B0%D8%A7%D8%AA%D9%8A%D8%A7-%D9%8A%D9%86%D8%A7%D8%B3%D8%A8%D9%83/)، وشغلناه بالأمر `weed server -s3` في Container واحد:

```text
--- put #1 with If-None-Match: *
{
    "ETag": "\"5bbf5a52328e7439ae6e719dfe712200\"",
    "ChecksumCRC64NVME": "H1SXwIjuQik="
}
exit=0
--- put #2 with If-None-Match: *

aws: [ERROR]: An error occurred (PreconditionFailed) when calling the PutObject operation: At least one of the pre-conditions you specified did not hold
exit=254
```

هذا هو السلوك الصحيح: الكتابة الأولى نجحت، والثانية رفضت بالخطأ `PreconditionFailed`. ولاحظ أننا شغلنا SeaweedFS في المختبر دون أي مفاتيح وصول، فهو يقبل أي مفتاح، وهذا للمختبر فقط، أما على سيرفر حقيقي فتعرف المستخدمين وصلاحياتهم في ملف الإعداد الذي يمرر بالخيار `-s3.config`. ثم غيرنا عنوان التخزين في `backend.tf` إلى `http://wr-iac-seaweed:8333`، ونقلنا الحالة بالأمر نفسه `tofu init -migrate-state`، فقرأتها الأداة من Garage وكتبتها في SeaweedFS، وأعدنا التجربة: تطبيق من الجهاز الأول ينتظر 45 ثانية، وفي أثنائه نظرنا في محتوى المساحة:

```text
2026-11-05 00:23:03       9735 shop/prod/terraform.tfstate
2026-11-05 00:25:18        224 shop/prod/terraform.tfstate.tflock
```

كائن القفل موجود بجانب الحالة، وحجمه 224 بايت، وهذا محتواه:

```json
{"ID":"db1e9630-1ebd-5ab2-675e-da8203528040","Operation":"OperationTypeApply","Info":"","Who":"root@194482e5b92a","Version":"1.13.2","Created":"2026-11-05T00:25:18.652834799Z","Path":"tofu-state/shop/prod/terraform.tfstate"}
```

ثم طلبنا الخطة من الجهاز الثاني:

```text
Error: Error acquiring the state lock

Error message: operation error S3: PutObject, https response error
StatusCode: 412, RequestID: 18E4FE7967B6B7B74153D90C, HostID: , api error
PreconditionFailed: At least one of the pre-conditions you specified did not
hold
Lock Info:
  ID:        db1e9630-1ebd-5ab2-675e-da8203528040
  Path:      tofu-state/shop/prod/terraform.tfstate
  Operation: OperationTypeApply
  Who:       root@194482e5b92a
  Version:   1.13.2
  Created:   2026-11-05 00:25:18.652834799 +0000 UTC
  Info:

OpenTofu acquires a state lock to protect the state from being written
by multiple users at the same time. Please resolve the issue above and try
again. For most commands, you can disable locking with the "-lock=false"
flag, but this is not recommended.
```

في المخرج أعلاه لاحظ التالي:

- السطر `StatusCode: 412` هو رد التخزين على الكتابة المشروطة، أي أن الأداة حاولت أن تكتب قفلها فرفض التخزين لأن هناك قفلاً، وهذا هو الدليل على أن القفل يعمل.
- الأداة قرأت كائن القفل وطبعت ما فيه: معرف القفل `ID`، ونوع العملية `OperationTypeApply`، أي أن من يملك القفل يطبق وليس يخطط فقط، ووقت إنشائه بتوقيت UTC.
- الحقل `Who` قيمته `root@194482e5b92a`، وهو اسم المستخدم واسم الجهاز الذي شغل الأمر، ولأننا نشغل الأداة في Container فاسم الجهاز هو رقم ال Container، ولا يقول لك شيئاً عن الشخص. وهذا ما يحدث أيضاً في خطوط CI/CD، لذلك الأسهل أن تجعل كل تطبيق يمر من الخط وحده، فيصبح سؤال «من يملك القفل؟» إجابته دائماً «المهمة رقم كذا في الخط»، وتستطيع أن تفتح صفحتها وترى هل ما زالت تعمل.
- الأداة اقترحت `-lock=false` وقالت إنه غير منصوح به، وهذه من المرات القليلة التي يجب أن تأخذ فيها كلام الأداة حرفياً: لا تستخدمه أبداً مع أمر يكتب الحالة.

وإذا كنت تعرف أن زميلك سوف ينتهي بعد قليل، فلا تحتاج أن تعيد الأمر بيدك، فالخيار `-lock-timeout=60s` يجعل الأداة تنتظر القفل حتى المدة التي تحددها قبل أن تفشل، وهو الخيار المناسب في خطوط CI/CD التي قد تبدأ مهمتان فيها في وقت متقارب.

## ماذا لو انقطع التطبيق في منتصفه؟ Stale Lock

القفل يحميك عندما يعمل الجميع بشكل طبيعي، ولكن ماذا يحدث إذا انقطع التطبيق؟ مثل أن يغلق الزميل غطاء اللابتوب، أو ينقطع اتصال VPN، أو يلغى خط CI/CD لأنه تجاوز وقته. لكي نعرف شغلنا تطبيقاً ينتظر 60 ثانية، ثم أوقفنا ال Container الذي يشغله بالأمر `docker kill` بعد 15 ثانية، وهو أقرب شيء إلى انقطاع الكهرباء عن الأداة، فلا تحصل على فرصة لتنظف شيئاً. ثم طلبنا الخطة من الجهاز الثاني مع انتظار عشر ثوان:

```bash
tofu plan -lock-timeout=10s
```

```text
Error: Error acquiring the state lock

Error message: operation error S3: PutObject, https response error
StatusCode: 412, RequestID: 18E4FEA4300D8AB7CA020BCF, HostID: , api error
PreconditionFailed: At least one of the pre-conditions you specified did not
hold
Lock Info:
  ID:        cec0f38b-9ff4-b8d1-2d2b-2d97b011a1f9
  Path:      tofu-state/shop/prod/terraform.tfstate
  Operation: OperationTypeApply
```

الأداة التي كانت تطبق ماتت، ولكن كائن القفل بقي في التخزين، ولن يحذفه أحد، فهذا قفل عالق Stale Lock، وسوف يمنع كل الفريق من العمل إلى أن يفتحه شخص. ولفتحه يوجد الأمر `force-unlock`، وهو يحتاج إلى معرف القفل نفسه، كما في [وثائق الأمر force-unlock](https://opentofu.org/docs/cli/commands/force-unlock/?ref=arabroot.io). وفي المرة التالية أخطأنا فأعطيناه معرفاً خاطئاً، فرفض:

```text
Error: Failed to unlock state: lock id "412," from s3 does not match existing lock
Lock Info:
  ID:        792b942b-eb38-d118-ba3c-fb1c5cce8a14
  Path:      tofu-state/shop/prod/terraform.tfstate
  Operation: OperationTypeApply
```

وهذا تصميم مقصود: الأمر لا يفتح «أي قفل موجود»، وإنما يفتح القفل الذي تسميه بمعرفه فقط، والسبب أن القفل الذي رأيته قبل دقيقة قد يكون انتهى وجاء بعده قفل جديد لزميل يطبق الآن فعلاً، فإذا فتحته فقد أعدت المشكلة التي جاء القفل ليحلها. ومع المعرف الصحيح:

```bash
tofu force-unlock -force 792b942b-eb38-d118-ba3c-fb1c5cce8a14
```

```text
OpenTofu state has been successfully unlocked!
```

والقاعدة قبل أي `force-unlock` أن تتأكد بنفسك أن العملية التي تملك القفل لم تعد تعمل: اسأل الزميل، أو انظر في صفحة الخط هل المهمة ما زالت تعمل، وانظر إلى وقت إنشاء القفل. ولا تقم بفتح قفل لأنك «تنتظر منذ دقائق»، فبعض التطبيقات، مثل إنشاء قاعدة بيانات مدارة عند مزود سحابي، تأخذ عشرين دقيقة أو أكثر.

### والمشكلة الأخطر: مورد أنشأه التطبيق ولا تعرفه الحالة Orphan Resource

فتح القفل يعيد الفريق إلى العمل، ولكنه لا يجيب عن سؤال أهم: ماذا فعل التطبيق قبل أن يموت؟ ولكي نرى ذلك أعدنا التجربة بطريقة أدق: طلبنا رفع عدد السيرفرات إلى أربعة، وانتظرنا حتى طبعت الأداة `docker_container.web[3]: Creating...`، ثم أوقفناها بعد ثانية:

```text
--- A output:
terraform_data.slow: Creation complete after 0s [id=743bbbf6-474e-5ae8-2d9e-1840c140a01a]
docker_container.web[3]: Creating...
--- docker:
wr-iac-web-4 Created
wr-iac-web-3 Up 44 minutes
wr-iac-web-1 Up 51 minutes
wr-iac-web-2 Up 51 minutes
```

ال Container `wr-iac-web-4` موجود في Docker، فقد طلبته الأداة من Docker قبل أن تموت، ولكنها لم تصل إلى اللحظة التي تكتب فيها معرفه في الحالة. وبعد أن فتحنا القفل نظرنا في الحالة:

```text
docker_container.web[0]
docker_container.web[1]
docker_container.web[2]
docker_image.web
docker_network.app
random_password.db
terraform_data.slow
```

ثلاثة سيرفرات فقط، أي أن الحالة لا تعرف السيرفر الرابع، وهذا هو المورد اليتيم Orphan Resource: موجود ويعمل وقد يكلفك مالاً، ولا تديره الأداة. وعندما أعدنا التطبيق نفسه حاولت الأداة أن تنشئه من جديد:

```text
docker_container.web[3]: Creating...
Error: Unable to create container: Error response from daemon: Conflict. The container name "/wr-iac-web-4" is already in use by container "fe98dbfba4d104cfdac1b23f764cefdcfe349fe51364a37168c91b1ad0d80e8d". You have to remove (or rename) that container to be able to reuse that name.
  with docker_container.web[3],
  on main.tf line 31, in resource "docker_container" "web":
  31: resource "docker_container" "web" {
```

ومرة أخرى أنقذنا Docker لأنه يرفض الاسم المكرر، وعند مزود يقبل الأسماء المكررة لكان عندك الآن سيرفران «رابعان»، واحد في الحالة وواحد لا يعرفه أحد. والحل أن تعرف الأداة بالمورد الموجود بدلاً من أن تنشئه، وهذا ما يفعله الأمر `import`، كما في [وثائق الأمر import](https://opentofu.org/docs/cli/commands/import/?ref=arabroot.io)، وهو يأخذ اسم المورد في الكود ومعرفه عند المزود، والمعرف هنا هو الذي طبعه Docker في رسالة الخطأ نفسها:

```bash
tofu import -var web_count=4 'docker_container.web[3]' fe98dbfba4d104cfdac1b23f764cefdcfe349fe51364a37168c91b1ad0d80e8d
tofu plan -var web_count=4
```

```text
Import successful!

The resources that were imported are shown above. These resources are now in
your OpenTofu state and will henceforth be managed by OpenTofu.

  # docker_container.web[3] must be replaced
      + env                                         = (sensitive value) # forces replacement
        # (8 unchanged attributes hidden)
      + networks_advanced { # forces replacement
Plan: 1 to add, 0 to change, 1 to destroy.
```

في المخرج أعلاه لاحظ أن الاستيراد نجح، ولكن الخطة بعده تريد استبدال ال Container، والسبب أن الأداة ماتت بعد أن أنشأته وقبل أن تربطه بالشبكة وتمرر له متغيرات البيئة، فهو موجود ولكنه ناقص، ولا يطابق الكود. والاستبدال هنا هو التصرف الصحيح، لأنه سيرفر لم يخدم أي طلب بعد. أما إذا كان المورد اليتيم قاعدة بيانات فيها بيانات، فاقرأ سطر `forces replacement` مرتين، وأصلح الكود ليطابق المورد بدلاً من أن تترك الأداة تستبدله.

ولاحظ أن OpenTofu يدعم أيضاً كتلة `import` داخل الكود، كما في [وثائق كتل الاستيراد](https://opentofu.org/docs/language/import/?ref=arabroot.io)، وهي الطريقة الأفضل في الفريق، لأن الاستيراد يظهر في الخطة ويمر من طلب الدمج مثل أي تغيير آخر، بدلاً من أمر يشغله شخص على جهازه. والصورة التالية تلخص ما يحدث عندما ينقطع التطبيق:

![خط زمني لتطبيق انقطع: الأداة تكتب القفل، ثم تطلب من Docker إنشاء wr-iac-web-4، ثم تموت بالأمر docker kill قبل أن تكتب المعرف في الحالة، فيبقى أمران: قفل عالق في التخزين يمنع الفريق ويفتح بالأمر force-unlock مع المعرف الصحيح فقط، ومورد يتيم موجود في Docker وغير موجود في الحالة يسبب خطأ Conflict عند التطبيق التالي ويصلح بالأمر import](https://arabroot.io/content/images/2026/11/tofu-state-04-killed-apply.webp)

التطبيق المنقطع يترك قفلاً عالقاً ومورداً يتيماً، والأول يمنعك من العمل والثاني يكلفك دون أن تعرف

## الحالة في PostgreSQL: pg Backend مع Advisory Locks

إذا كان عندك PostgreSQL يعمل ويحمل نسخاً احتياطية منتظمة، وأغلب الفرق عندها واحد، فقد لا تحتاج إلى تخزين S3 للحالة أصلاً، فـ OpenTofu يأتي بخلفية اسمها `pg` تحفظ الحالة في جدول داخل قاعدة البيانات. وتقول [وثائق خلفية pg](https://opentofu.org/docs/language/settings/backends/pg/?ref=arabroot.io) إنها تحتاج إلى PostgreSQL بالإصدار 10 أو أحدث، وإنها تقفل الحالة بالأقفال الاستشارية Advisory Locks. وهذا هو الإعداد كاملاً:

```hcl
terraform {
  backend "pg" {
    # conn_str comes from the PG_CONN_STR environment variable (never in Git)
    schema_name = "shop_prod"
  }
}
```

والعنوان الذي يتصل به، ومعه كلمة المرور، يمر في متغير البيئة `PG_CONN_STR`، فلا يوجد في الملف إلا اسم المخطط Schema الذي تحفظ فيه هذه الحالة. وشغلنا PostgreSQL 18.6 من ال Image `postgres:18-alpine`، ثم نقلنا الحالة إليه بالأمر نفسه `tofu init -migrate-state`، ونظرنا في قاعدة البيانات:

```text
           List of tables
  Schema   |  Name  | Type  | Owner
-----------+--------+-------+-------
 shop_prod | states | table | tofu
(1 row)

 id |  name   | bytes
----+---------+-------
  1 | default |  9734
(1 row)
```

الأداة أنشأت المخطط والجدول وحدها، والجدول فيه سطر واحد لكل مساحة عمل Workspace، واسم السطر `default` لأننا لا نستخدم مساحات عمل، وعمود `data` فيه الحالة كلها بصيغة JSON. وهذا يعني أن الحالة الآن جزء من قاعدة بيانات لها نسخ احتياطية واستعادة إلى أي لحظة، كما شرحنا في [استعادة PostgreSQL إلى أي لحظة](https://arabroot.io/articles/%D8%A7%D8%B3%D8%AA%D8%B9%D8%A7%D8%AF%D8%A9-postgresql-%D8%A7%D9%84%D9%89-%D8%A7%D9%8A-%D9%84%D8%AD%D8%B8%D8%A9-%D9%85%D8%B9-pgbackrest/)، وهذه ميزة لا يعطيك إياها Garage مثلاً لأنه لا يحفظ النسخ القديمة.

ثم كررنا تجربة القفل: تطبيق من الجهاز الأول ينتظر 40 ثانية، وفي أثنائه سألنا PostgreSQL عن الأقفال الاستشارية الموجودة:

```sql
select l.locktype, l.objid, l.mode, l.granted, a.application_name, a.client_addr
from pg_locks l join pg_stat_activity a using (pid)
where l.locktype = 'advisory';
```

```text
 locktype | objid |     mode      | granted | application_name | client_addr
----------+-------+---------------+---------+------------------+-------------
 advisory |     1 | ExclusiveLock | t       |                  | 172.18.0.5
(1 row)
```

هناك قفل استشاري واحد، ورقمه `objid = 1` وهو نفسه رقم سطر الحالة في الجدول، ونوعه حصري `ExclusiveLock`، ويملكه اتصال من العنوان `172.18.0.5`، وهو ال Container الذي يطبق. والقفل الاستشاري في PostgreSQL قفل لا يحمي جدولاً ولا سطراً، وإنما رقم يتفق عليه البرنامج مع نفسه، فلا يستطيع اتصال آخر أن يأخذ القفل على الرقم نفسه ما دام الأول يملكه، كما في [وثائق الأقفال في PostgreSQL](https://www.postgresql.org/docs/18/explicit-locking.html?ref=arabroot.io). ثم طلبنا الخطة من الجهاز الثاني:

```text
Error: Error acquiring the state lock

Error message: Workspace is already locked: default
Lock Info:
  ID:        2f359d03-e666-f5e4-638a-77bc1b1d85de
  Path:
  Operation: OperationTypePlan
  Who:       root@dd8bee6b4c40
  Version:   1.13.2
  Created:   2026-11-05 00:49:42.142263896 +0000 UTC
  Info:
```

القفل يعمل، ولكن لاحظ شيئاً مختلفاً عن خلفية S3: معلومات القفل المطبوعة ليست معلومات من يملكه، وإنما معلومات الجهاز الثاني نفسه، فالعملية `OperationTypePlan` وهي الخطة التي طلبناها، والمعرف جديد. والسبب أن القفل الاستشاري رقم فقط، ولا يحمل معه نصاً يقول من أخذه ولماذا، كما يفعل كائن `.tflock` في S3\. لذلك عندما ترى هذه الرسالة مع خلفية pg فلا تبحث عن صاحب القفل فيها، وإنما ابحث عنه في `pg_stat_activity` بالاستعلام أعلاه، فهو يعطيك عنوان الجهاز ووقت بداية الاتصال.

### ماذا لو انقطع التطبيق هنا؟ Session Locks

وهنا أهم فرق بين الخلفيتين، فقد كررنا تجربة القطع نفسها: تطبيق ينتظر 50 ثانية، أوقفناه بالأمر `docker kill`، ثم راقبنا الأقفال الاستشارية:

```text
killed at 03:52:04
advisory locks gone at 03:52:04
Plan: 1 to add, 0 to change, 1 to destroy.
```

القفل اختفى في الثانية نفسها، وعمل الجهاز الثاني مباشرة دون `force-unlock`. والسبب أن القفل الاستشاري مرتبط بالجلسة Session، فعندما ينقطع اتصال الأداة بقاعدة البيانات تفتح PostgreSQL كل أقفال هذه الجلسة وحدها، ولهذا تقول وثائق الخلفية إن `force-unlock` غير مدعوم فيها أصلاً. ولكن انتبه لحالة واحدة: إذا لم ينقطع الاتصال بشكل نظيف، مثل لابتوب نام ولم يغلق الاتصال، فقد يبقى الاتصال مفتوحاً في نظر السيرفر حتى ينتهي وقت الاتصال TCP، فإذا رأيت قفلاً لا صاحب له فابحث عن الاتصال في `pg_stat_activity` وأنهه بالدالة `pg_terminate_backend`. ولاحظ أيضاً أن المورد اليتيم لا يختفي مع القفل، فالخلفية تحل مشكلة القفل العالق فقط، أما ما أنشأه التطبيق المنقطع ولم يسجله فيبقى كما رأيت مع S3.

![مقارنة بين الخلفيات الأربع التي شغلناها: Local تحفظ ملفاً على جهازك ولا تشارك الحالة وتكتب نسخة backup واحدة، وGarage 2.4.1 يشارك الحالة ولكن القفل لا يعمل لأنه يتجاهل If-None-Match ولا يدعم Versioning، وSeaweedFS 4.48 يشارك الحالة والقفل يعمل بالرمز 412 ويحتاج force-unlock عند الانقطاع، وPostgreSQL 18 مع pg يشارك الحالة ويقفل بأقفال استشارية تفتح وحدها عند انقطاع الاتصال ويأخذ النسخ الاحتياطي من قاعدة البيانات](https://arabroot.io/content/images/2026/11/tofu-state-05-backends.webp)

أربع خلفيات شغلناها، وما الذي يحدث في كل منها للمشاركة والقفل والانقطاع

## تشفير الحالة في OpenTofu: State Encryption

حتى الآن حللنا المشاركة والقفل، وبقيت الحماية: الحالة في PostgreSQL ما زالت JSON بنص واضح، وأي شخص يقرأ الجدول أو يملك نسخة احتياطية من قاعدة البيانات يقرأ كلمة المرور. والحل التقليدي هو تشفير التخزين نفسه، مثل تشفير القرص أو تشفير المساحة عند المزود، ولكن هذا يحميك من شخص سرق القرص فقط، أما من يملك صلاحية القراءة من قاعدة البيانات أو من المساحة فيقرأ الحالة مفكوكة. لذلك أضاف OpenTofu منذ الإصدار 1.7 تشفير الحالة من جهة العميل Client-side Encryption، أي أن الأداة نفسها تشفر الحالة قبل أن ترسلها إلى الخلفية، وتفكها بعد أن تقرأها، فلا يرى التخزين ولا من يديره إلا بيانات مشفرة، كما في [وثائق تشفير الحالة](https://opentofu.org/docs/language/state/encryption/?ref=arabroot.io).

والتشفير يحتاج إلى شيئين: مزود المفتاح Key Provider الذي يعطي مفتاح التشفير، وطريقة التشفير Method التي تستخدم المفتاح. وأبسط مزود مفتاح هو `pbkdf2`، وهو يشتق المفتاح من عبارة مرور Passphrase، وتوجد مزودات أخرى تأخذ المفتاح من مدير أسرار مثل OpenBao أو من خدمة مفاتيح سحابية، وهذا ما سوف نعود إليه في مقال مديري الأسرار. ولأن عندنا حالة غير مشفرة يجب أن نقرأها أول مرة، أضفنا طريقة اسمها `unencrypted` كخطة بديلة Fallback، فالأداة تحاول أن تقرأ بالتشفير، فإذا فشلت قرأت بدونه، ثم تكتب دائماً بالتشفير:

```hcl
variable "state_passphrase" {
  description = "Passphrase for state encryption (set with TF_VAR_state_passphrase)"
  type        = string
  sensitive   = true
}

terraform {
  encryption {
    key_provider "pbkdf2" "main" {
      passphrase = var.state_passphrase
    }
    method "aes_gcm" "main" {
      keys = key_provider.pbkdf2.main
    }
    # Only for the first run: lets OpenTofu read the old unencrypted state
    method "unencrypted" "migrate" {}

    state {
      method = method.aes_gcm.main
      fallback {
        method = method.unencrypted.migrate
      }
    }
    plan {
      method = method.aes_gcm.main
      fallback {
        method = method.unencrypted.migrate
      }
    }
  }
}
```

في الإعداد أعلاه لاحظ التالي:

- عبارة المرور تأتي من متغير، وقيمته تمر في متغير البيئة `TF_VAR_state_passphrase`، وولدناها بالأمر `openssl rand -base64 24`، فلا توجد في أي ملف داخل المستودع. وقبول المتغيرات داخل كتلة التشفير جاء مع التقييم المبكر Early Evaluation في [الإصدار 1.8](https://opentofu.org/blog/opentofu-1-8-0/?ref=arabroot.io).
- الكتلة `plan` تشفر ملف الخطة المحفوظ أيضاً، وهذا مهم لأننا رأينا في المقال السابق أن ملف الخطة يحمل قيم المتغيرات الحساسة بنص واضح.
- الطريقة `aes_gcm` هي التشفير بخوارزمية AES في نمط GCM، وهذا النمط لا يشفر فقط، وإنما يتحقق أيضاً أن البيانات لم تعدل، وهذا ما سوف تراه في رسالة الخطأ بعد قليل.

ثم طبقنا مرة واحدة، فقرأت الأداة الحالة القديمة بالطريقة البديلة، وكتبتها مشفرة، وهذا ما أصبح في قاعدة البيانات قبل التطبيق وبعده:

```text
{"version":4,"terraform_version":"1.13.2","serial":2,"lineag
{"serial":3,"lineage":"9e32b58d-85a1-d87d-cbe4-6afafd88f7b5","meta":{"key_provider.pbkdf2.main":"eyJzYWx0IjoiMWxzOTVhNFhPSS9QWEZHSzJFalNGdE1nQW5DRnpsNjViRWJTelJpOGc4RT0iLCJpdGVyYXRpb25zIjo2MDAwMDAsImhhc2hfZnVuY3Rpb24iOiJzaGE1MTIiLCJrZXlfbGVuZ3RoIjozMn0="},"encrypted_data":"+znfAnJhbtk9cwrhKez89LY/5m
```

وبحثنا عن كلمة المرور في الجدول بعد التشفير فكانت النتيجة 0، أي أنها لم تعد موجودة بنص واضح. وفي المخرج أعلاه لاحظ التالي:

- الحقلان `serial` و`lineage` بقيا بنص واضح خارج التشفير، والسبب أن الأداة تحتاجهما لتقارن النسخ وتمنع الكتابة فوق حالة أحدث قبل أن تفك أي شيء.
- الحقل `meta` فيه معلومات اشتقاق المفتاح بصيغة Base64، وعندما فككناه كان كما يلي: `{"salt":"1ls95a4XOI/PXFGK2EjSFtMgAnCFzl65bEbSzRi8g8E=","iterations":600000,"hash_function":"sha512","key_length":32}`، أي ملح Salt عشوائي، و600 ألف دورة من دالة الهاش SHA-512، ومفتاح طوله 32 بايت، وهي القيم الافتراضية في الوثائق. والملح والدورات ليست سراً، فوجودها هنا طبيعي، ووظيفة الدورات الكثيرة أن تجعل تجربة عبارات مرور كثيرة على الملف بطيئة جداً على المخترق.
- الحقل `encrypted_data` هو الحالة كلها مشفرة، ومنها أسماء الموارد والعناوين وكلمة المرور.

### ماذا لو أخطأت في عبارة المرور Passphrase؟

جربنا الخطة بعبارة مرور خاطئة:

```text
Warning: Unencrypted method configured

  on encryption.tf line 8, in terraform:
   8:   encryption {

Method unencrypted is present in configuration. This is a security risk and
should only be enabled during migrations.

Error: error loading state: decryption failed for all provided methods
attempted decryption failed for state: decryption failed: cipher: message authentication failed
```

في المخرج أعلاه لاحظ أن الأداة جربت الطريقتين، التشفير ثم الطريقة البديلة، وفشلت في الاثنتين، والعبارة `message authentication failed` هي نمط GCM يقول إن المفتاح لا يطابق، فلا تحصل على بيانات خاطئة مفكوكة بمفتاح خاطئ، وإنما على رفض واضح. ولاحظ أيضاً التحذير الأول: الأداة تذكرك في كل أمر أن الطريقة غير المشفرة ما زالت في الإعداد، لأنها تسمح بقراءة حالة غير مشفرة، وأي شخص يستطيع أن يكتب حالة غير مشفرة في الخلفية سوف تقبلها الأداة. لذلك بعد أول تطبيق ناجح أزلنا الطريقة البديلة وأضفنا `enforced = true`، فترفض الأداة أن تكتب أي حالة دون تشفير:

```hcl
    state {
      method   = method.aes_gcm.main
      enforced = true # refuse to write the state without encryption
    }
    plan {
      method   = method.aes_gcm.main
      enforced = true
    }
```

وبعدها خرجت الخطة بعبارة المرور الصحيحة `No changes`، أما دون عبارة المرور فتوقفت الأداة قبل أن تقرأ أي شيء:

```text
  on encryption.tf line 8, in terraform:
   8:   encryption {

encryption.key_provider.pbkdf2.main depends on var.state_passphrase which is
not available
```

والآن السؤال الذي يجب أن تسأله قبل أن تفعل التشفير في الإنتاج: ماذا لو ضاعت عبارة المرور؟ والإجابة أن الحالة تضيع معها، ولا توجد طريقة لاستعادتها، وتقول الوثائق ذلك صراحة، وتطلب أن تأخذ نسخة احتياطية من الحالة غير المشفرة قبل التفعيل، وأن تحفظ المفاتيح نفسها في مكان له نسخ احتياطية. وتذكر أن ضياع الحالة لا يحذف البنية، ولكنه يعيدك إلى مشكلة الجهاز الثاني: الأداة لا تعرف شيئاً، وعليك أن تستورد كل مورد بيدك. ولاحظ أيضاً ما تقوله الوثائق عن الأسماء: لا تقم بتغيير اسم مزود المفتاح أو الطريقة بعد التشفير، لأن الاسم `key_provider.pbkdf2.main` محفوظ في الحقل `meta` كما رأيت، فإذا غيرته لم تعرف الأداة كيف تفك الحالة.

![تشفير الحالة من جهة العميل: OpenTofu يأخذ عبارة المرور من TF_VAR_state_passphrase فيشتق منها مفتاحاً بـ PBKDF2 مع SHA-512 و600000 دورة، ثم يشفر الحالة بـ AES-GCM قبل أن يرسلها إلى PostgreSQL، فيرى التخزين serial وlineage وmeta بنص واضح وencrypted_data مشفرة، وبجانبها ثلاث حالات: عبارة خاطئة تعطي message authentication failed، وغياب العبارة يوقف الأداة قبل القراءة، وtofu state pull يطبع الحالة مفكوكة](https://arabroot.io/content/images/2026/11/tofu-state-06-encryption.webp)

الأداة تشفر قبل أن ترسل، فلا يرى التخزين ولا من يديره ولا النسخ الاحتياطية إلا بيانات مشفرة

## النسخ الاحتياطي للحالة: Versioning مع state pull

الحالة ملف صغير، ولكنه أهم ملف في المشروع، فإذا كتبت فوقه نسخة خاطئة، مثل أن ينقل أحد الحالة بالأمر `-migrate-state` ويختار الإجابة الخاطئة، فأنت تحتاج أن ترجع إلى النسخة السابقة خلال دقائق. والطريقة التي تنصح بها وثائق خلفية S3 هي تفعيل تعدد النسخ Versioning على المساحة، فيحفظ التخزين كل نسخة قديمة من الحالة تلقائياً، وتستطيع أن ترجع إلى أي واحدة منها. ولكن رأينا أن Garage لا يدعم ذلك، لذلك إذا اخترت تخزيناً لا يحفظ النسخ فعليك أن تأخذ النسخ بنفسك.

والأمر الذي يخطر للجميع هو `tofu state pull`، فهو يطبع الحالة الحالية من الخلفية، كما في [وثائق الأمر state pull](https://opentofu.org/docs/cli/commands/state/pull/?ref=arabroot.io)، وتستطيع أن تحفظه في ملف بتاريخ اليوم. ولكن جربناه بعد التشفير فوجدنا ما يلي:

```text
{"version":4,"terraform_version":"1.13.2","serial":3,"lineage":"9e32b58d-85a1-d87d-cbe4-6afafd88f7b5","outputs":{"web_names":{"value":["wr-iac-web-1","wr-iac-web-2","wr-iac-web-3"],...
```

الأمر يطبع الحالة مفكوكة، لأن الأداة تفكها قبل أن تعطيك إياها، وعندما بحثنا فيه عن `APP_DB_PASSWORD` وجدناها. أي أن سكربت النسخ الاحتياطي الذي يحفظ مخرج `state pull` في مجلد يعيد كتابة الأسرار بنص واضح في مكان آخر، ويلغي فائدة التشفير. أما نسخة قاعدة البيانات نفسها بالأمر `pg_dump` فلم نجد فيها كلمة المرور، لأنها تنسخ العمود كما هو، أي مشفراً. لذلك القاعدة هنا أن تنسخ الحالة من الخلفية كما هي، أي نسخة قاعدة البيانات أو نسخة الكائن من التخزين، ولا تنسخ مخرج `state pull`، وإذا احتجت إليه في حالة طارئة فاحذفه بعد الاستخدام. وتذكر أن النسخة المشفرة لا فائدة منها دون عبارة المرور، فاحفظ العبارة في مدير كلمات المرور للفريق، مثل الذي شرحناه في [تثبيت Vaultwarden](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-vaultwarden-%D9%85%D8%AF%D9%8A%D8%B1-%D9%83%D9%84%D9%85%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B1%D9%88%D8%B1-%D9%84%D9%84%D9%81%D8%B1%D9%8A%D9%82/)، وفي مكان ثان خارج السيرفر نفسه، كما في [قاعدة 3-2-1](https://arabroot.io/articles/%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D8%A7%D9%84%D8%A7%D8%AD%D8%AA%D9%8A%D8%A7%D8%B7%D9%8A-%D8%A8%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-3-2-1-%D9%88%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%B9%D8%A7%D8%AF%D8%A9/).

## من يستطيع أن يقرأ الحالة؟ Access Control

التشفير يحمي الحالة من التخزين ومن النسخ الاحتياطية، ولكنه لا يحميها من الشخص الذي يملك عبارة المرور ومفتاح الخلفية معاً، وهذا الشخص هو كل من يشغل `tofu plan`. لذلك السؤال الحقيقي ليس «هل الحالة مشفرة؟» وإنما «من يملك المفتاحين؟». وفي فريق صغير يبدأ كل شيء بأن يملك كل مطور المفتاحين على جهازه، وهذا مقبول في البداية، ولكنه يعني أن أي لابتوب مسروق فيه كل أسرار البنية. والترتيب الذي تصل إليه أغلب الفرق كما يلي:

1. مفتاح الخلفية وعبارة المرور يملكهما خط CI/CD وحده، ويحفظهما في أسرار الخط، والمطورون يرون الخطة في طلب الدمج دون أن يملكوا المفاتيح، وهذا ما سوف نبنيه في مقال تشغيل OpenTofu من CI/CD.
2. مفتاح لكل بيئة ولكل مشروع، فمفتاح بيئة الاختبار لا يقرأ حالة الإنتاج، وهذا سهل في Garage وSeaweedFS لأن الصلاحيات على مستوى المساحة والمفتاح، وسهل في PostgreSQL بمستخدم لكل مخطط.
3. عدد قليل من الأشخاص يملك مفاتيح الطوارئ، ويستخدمها عند تعطل الخط أو القفل العالق، ويكتب في سجل الحوادث كل مرة استخدمها فيها.
4. الأسرار نفسها تخرج من الحالة كلما أمكن، فبدلاً من أن تولد الأداة كلمة مرور قاعدة البيانات وتحفظها، تقرؤها من مدير أسرار عند التطبيق، وبعض المزودات الحديثة تدعم القيم المؤقتة Ephemeral التي لا تحفظ في الحالة أصلاً.

## أي خلفية تختار؟ Backend Decision

بعد كل ما شغلناه، الاختيار يعتمد على ما يوجد عندك أصلاً، فلا تضف خدمة جديدة لتحفظ ملفاً حجمه عشرة كيلوبايت إذا كان عندك ما يكفي. والجدول التالي يجمع ما رأيناه:

| الخلفية              | المشاركة | القفل                             | عند انقطاع التطبيق            | النسخ القديمة               | متى تختارها                        |
| -------------------- | -------- | --------------------------------- | ----------------------------- | --------------------------- | ---------------------------------- |
| Local                | لا تشارك | على الجهاز نفسه فقط               | لا ينطبق                      | نسخة backup واحدة           | شخص واحد ومختبر                    |
| S3 مع Garage 2.4.1   | نعم      | لا يعمل، لأن If-None-Match يتجاهل | لا يوجد قفل يعلق              | لا يدعم Versioning          | لا تستخدمه للحالة مع use\_lockfile |
| S3 مع SeaweedFS 4.48 | نعم      | يعمل بالرمز 412                   | قفل عالق يفتح بـ force-unlock | بحسب إعداد التخزين          | إذا كان عندك تخزين S3 يمر الاختبار |
| S3 عند AWS           | نعم      | يعمل منذ دعم الكتابة المشروطة     | قفل عالق يفتح بـ force-unlock | Versioning مدعوم            | بنيتك أصلاً عند AWS                |
| pg مع PostgreSQL     | نعم      | أقفال استشارية                    | يفتح وحده عند انقطاع الاتصال  | من نسخ قاعدة البيانات وPITR | عندك PostgreSQL بنسخ احتياطية      |

وفي أي خيار من هذه، فعل تشفير الحالة من اليوم الأول، فإضافته لاحقاً ممكنة كما رأيت، ولكن كل نسخة احتياطية أخذت قبله تبقى بنص واضح.

## أخطاء شائعة Common Mistakes

- وضع ملف الحالة في Git: تصبح الأسرار في التاريخ إلى الأبد، ولا يوجد قفل، والتعارض في ملف JSON لا يحل بأمان.
- الثقة في «متوافق مع S3» دون اختبار: شغل طلبي `If-None-Match` على التخزين قبل أن تعتمد عليه للقفل، فقد رأيت أن الأداة لا تحذرك عند الحصول على قفل لا يعمل.
- ترك `terraform.tfstate.backup` على الأجهزة بعد النقل: الملف المحلي يصبح فارغاً، أما النسخة الاحتياطية بجانبه فتبقى كاملة بأسرارها.
- استخدام `-lock=false` لأن القفل «يزعج»: هو الحماية الوحيدة من تطبيقين في اللحظة نفسها.
- فتح القفل دون معرفة صاحبه: تأكد أن العملية التي تملكه انتهت فعلاً، ثم افتحه بمعرفه.
- تجاهل ما فعله التطبيق المنقطع: بعد أي انقطاع اطلب الخطة، وابحث عن موارد يتيمة عند المزود قبل أن تطبق مرة أخرى.
- الاعتماد على `sensitive` كأنه حماية: هو يخفي القيمة على الشاشة فقط، والحالة تحفظها بنص واضح حتى تفعل التشفير.
- نسخ الحالة احتياطياً بالأمر `state pull` بعد التشفير: يكتب الأسرار مفكوكة في مكان آخر.
- عبارة مرور التشفير في مكان واحد: إذا ضاعت ضاعت الحالة معها.
- مفتاح خلفية واحد لكل البيئات: من يقرأ حالة الاختبار يقرأ حالة الإنتاج.

## قائمة التحقق Checklist

| قبل أن تعتبر الحالة جاهزة لفريق   | كيف تتحقق                                                                      |
| --------------------------------- | ------------------------------------------------------------------------------ |
| الحالة في خلفية مشتركة            | جهاز جديد يسحب المستودع ويشغل tofu plan فيخرج No changes                       |
| القفل يعمل فعلاً                  | تطبيق مفتوح من جهاز، وخطة من جهاز آخر تفشل بـ Error acquiring the state lock   |
| التخزين يحترم الكتابة المشروطة    | الطلب الثاني مع If-None-Match: \* يرجع 412                                     |
| لا توجد نسخ محلية قديمة           | لا يوجد terraform.tfstate\* فيه بيانات على أجهزة الفريق                        |
| الحالة والخطة مشفرتان             | كتلة encryption مع enforced = true، والبحث عن سر معروف في الخلفية لا يجد شيئاً |
| عبارة المرور لها نسختان           | في مدير كلمات المرور وفي مكان ثان خارج السيرفر                                 |
| النسخ الاحتياطي يحفظ الحالة مشفرة | Versioning أو نسخة قاعدة البيانات، وليس مخرج state pull                        |
| مفتاح لكل بيئة                    | مفتاح بيئة الاختبار لا يقرأ مسار الإنتاج                                       |
| خطة لما بعد الانقطاع              | من يملك صلاحية force-unlock، وكيف تبحث عن الموارد اليتيمة وتستوردها            |

## الخلاصة Summary

وصلنا لنهاية الموضوع، وأهم ما فيه:

- ملف الحالة هو الخريطة بين أسماء الكود ومعرفات المزود، وفيه كل الخصائص بنص واضح، ومنها كلمات المرور، والرقم `serial` والمعرف `lineage` يمنعان الكتابة بنسخة قديمة أو بحالة مشروع آخر.
- جهازان بحالتين محليتين يريان عالمين مختلفين، والخطة صحيحة عند كل منهما، والذي أنقذنا من سيرفرات مكررة هو Docker وليس الأداة.
- خلفية S3 مع `use_lockfile` تعتمد كلها على الكتابة المشروطة `If-None-Match`، وGarage 2.4.1 يتجاهلها فلا يقفل شيئاً، وSeaweedFS 4.48 يحترمها فيعمل القفل بالرمز 412.
- التطبيق المنقطع يترك قفلاً عالقاً يفتح بالأمر `force-unlock` مع معرفه الصحيح فقط، ومورداً يتيماً يصلح بالأمر `import`.
- خلفية pg تقفل بأقفال استشارية تفتح وحدها عند انقطاع الاتصال، وتأخذ نسخها الاحتياطية من قاعدة البيانات.
- تشفير الحالة في OpenTofu يحدث قبل أن تصل الحالة إلى الخلفية، ويبقى `serial` و`lineage` بنص واضح، وعبارة المرور إذا ضاعت ضاعت الحالة، و`state pull` يطبع الحالة مفكوكة.

وفي المقال التالي في المرحلة بإذن الله نقسم المشروع إلى وحدات Modules، ونضع حالة كل بيئة في مسارها، وبعده نشغل الخطة من خط CI/CD حتى لا يملك المفاتيح إلا الخط. والمقالات المرتبطة بهذا المقال:

[![](https://arabroot.io/content/images/2026/11/opentofu-first-cover-cover.webp)دليلأول بنية مع OpenTofu: سيرفرات مع سجلات DNS من ملف واحدمختبر يعمل على جهازك ينشئ السيرفرات وسجل DNS الذي يشير إليها من ملف واحد، ويقرأ معك كل سطر في مخرج init وplan وapply.](https://arabroot.io/articles/%D8%A7%D9%88%D9%84-%D8%A8%D9%86%D9%8A%D8%A9-%D9%85%D8%B9-opentofu-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D8%A7%D8%AA-%D9%85%D8%B9-%D8%B3%D8%AC%D9%84%D8%A7%D8%AA-dns-%D9%85%D9%86-%D9%85%D9%84%D9%81-%D9%88%D8%A7%D8%AD%D8%AF/)[![](https://arabroot.io/content/images/2026/10/iac-terms-cover-cover.webp)دليلمصطلحات البنية كشيفرة IaC التي تحتاجها قبل أي أداةما معنى أن تكتب بنيتك في ملفات داخل Git، ولماذا يفشل السكربت العادي عند تشغيله مرة ثانية، وما الذي تحفظه الأداة في ملف الحالة.](https://arabroot.io/articles/%D8%A7%D9%84%D8%A8%D9%86%D9%8A%D8%A9-%D9%83%D8%B4%D9%8A%D9%81%D8%B1%D8%A9-iac-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/)[![](https://arabroot.io/content/images/2026/10/terraform-opentofu-cover-cover.webp)دليلTerraform أم OpenTofu؟ قصة تغيير الترخيص وما يعنيه لكلماذا غير Terraform رخصته في 2023 فولد منه OpenTofu، وأين يختلف المشروعان اليوم، وكيف تختار بينهما.](https://arabroot.io/articles/terraform-%D8%A7%D9%85-opentofu-%D9%82%D8%B5%D8%A9-%D8%AA%D8%BA%D9%8A%D9%8A%D8%B1-%D8%A7%D9%84%D8%AA%D8%B1%D8%AE%D9%8A%D8%B5/)[![](https://arabroot.io/content/images/2026/10/s3-servers-compare-cover-cover.webp)دليلأي تخزين S3 مستضاف ذاتياً يناسبك؟ وما الذي تغير في MinIOمقارنة عملية بين أشهر أدوات تخزين S3 المستضافة ذاتياً بقياسات على جهاز واحد، لتعرف أيها يناسب سيرفرك وماذا حدث فعلاً ل MinIO.](https://arabroot.io/articles/%D8%A7%D9%8A-%D8%AA%D8%AE%D8%B2%D9%8A%D9%86-s3-%D9%85%D8%B3%D8%AA%D8%B6%D8%A7%D9%81-%D8%B0%D8%A7%D8%AA%D9%8A%D8%A7-%D9%8A%D9%86%D8%A7%D8%B3%D8%A8%D9%83/)

## سجل التحديثات Changelog

- نوفمبر 2026: كتابة المقال وتنفيذ المختبر بـ OpenTofu 1.13.2 داخل Image بنيناها من 1.13.2-minimal، مع مزود kreuzwerker/docker 4.6.0 ومزود hashicorp/random 3.9.1، وخلفية S3 على Garage v2.4.1 ثم SeaweedFS 4.48 مع aws-cli 2.37.12، وخلفية pg على PostgreSQL 18.6، وتشفير الحالة بـ pbkdf2 مع aes\_gcm، على Docker Engine 29.8.0.