ورقة مساعدة لدليل المبتدئين السريع في Ansible

دليل عملي شامل للانطلاق من الصفر في تثبيت Ansible وتنظيم ملفات الجرد وصياغة أول كتاب تشغيل YAML وإدارة مهام الخادم.

🔗 Related: ورقة مساعدة Ansible الأساسية · ورقة مساعدة أدوار Ansible · أمثلة كتب تشغيل Ansible

التثبيت

# macOS (Homebrew)
brew install ansible

# Ubuntu / Debian
sudo apt update && sudo apt install -y ansible

# Python Pip (Universal)
pip install ansible

راجع: وثائق تثبيت Ansible الرسمية: Ansible Installation Docs

---

إعداد المشروع

mkdir -p ~/ansible-setup
cd ~/ansible-setup

أنشئ دليل عمل مخصصا لملفات الجرد وكتب التشغيل وتعريفات المتغيرات الخاصة بك.

---

ملفات التكوين

ملف الجرد (Inventory)

hosts

[webservers]
192.168.0.10
192.168.0.11

[databases]
192.168.0.20

[local]
localhost ansible_connection=local

تحدد ملفات الجرد العقد المستهدفة مجمعة منطقيا. يمكنك استهداف localhost باستخدام ansible_connection=local لاختبار الأتمتة محليا دون الحاجة إلى SSH.

راجع: دليل إنشاء الجرد في Ansible: Ansible How to build your inventory

---

تعريف كتاب التشغيل (Playbook)

playbook.yml

---
- name: Basic Server Provisioning
  hosts: webservers
  become: true
  tasks:
    - name: Update apt package cache
      apt:
        update_cache: yes
        cache_valid_time: 3600

    - name: Ensure Nginx is installed
      apt:
        name: nginx
        state: present

    - name: Start Nginx and enable on boot
      service:
        name: nginx
        state: started
        enabled: yes

    - name: Create hello world banner
      shell: echo "Managed by Ansible" > /tmp/motd.txt

---

التنفيذ

التحقق والتشغيل

تحقق من الاتصال عبر اختبار ping السريع:

ansible -i hosts all -m ping

قم بتشغيل كتاب التشغيل الكامل مقابل ملف الجرد:

ansible-playbook -i hosts playbook.yml

التشغيل التجريبي (وضع الفحص Check Mode)

معاينة التغييرات المحتملة دون تطبيقها فعليا على العقد البعيدة:

ansible-playbook -i hosts playbook.yml --check --diff

---

المراجع

• دليل البدء الرسمي في Ansible
• وثائق كتب تشغيل Ansible