فاجرانت
| أمر | وصف |
|---------|-------------|
| vagrant version | أظهر إصدار Vagrant |
| vagrant -h | عرض معلومات المساعدة |
| vagrant init | قم بتهيئة ملف Vagrantfile جديد |
| vagrant init ubuntu/jammy64 | قم بالتهيئة مع صندوق محدد |دليل شامل لأوامر وسير عمل HashiCorp Vagrant لإدارة بيئات التطوير وتوفير الآلات الافتراضية.
التثبيت والإعداد
| أمر | وصف |
|---|
vagrant box list | قائمة الصناديق المثبتة |
vagrant box add ubuntu/jammy64 | أضف مربع |
vagrant box add --name mybox /path/to/box.box | أضف صندوق محلي |
vagrant box remove ubuntu/jammy64 | إزالة المربع |
vagrant box update | قم بتحديث جميع المربعات |
vagrant box update --box ubuntu/jammy64 | تحديث صندوق محدد |
عمليات الصندوق
| أمر | وصف |
|---|
vagrant box outdated | تحقق من الصناديق القديمة |
vagrant box prune | قم بإزالة الإصدارات القديمة من Box |
vagrant box repackage ubuntu/jammy64 | أعد تعبئة الصندوق |
| أمر | وصف |
|---|
vagrant up | ابدأ وجهز VM |
vagrant halt | إيقاف تشغيل VM |
vagrant reload | إعادة تشغيل VM |
vagrant destroy | دمر VM |
vagrant suspend | إيقاف تشغيل الـ VM مؤقتًا |
vagrant resume | استئناف VM المعلقة |
العمليات الأساسية
| أمر | وصف |
|---|
vagrant status | عرض حالة الآلة الافتراضية |
vagrant global-status | عرض حالة جميع الآلات الافتراضية |
vagrant global-status --prune | تنظيف الإدخالات غير الصالحة |
| أمر | وصف |
|---|
vagrant ssh | قم بالدخول عبر SSH إلى الماكينة الافتراضية |
vagrant ssh-config | أظهر تكوين SSH |
vagrant ssh -- -L 8080:localhost:80 | SSH مع توجيه المنافذ |
عمليات SSH
| أمر | وصف |
|---|
vagrant provision | قم بتشغيل المهيئين |
vagrant provision --provision-with shell | قم بتشغيل مُزوِّد محدد |
vagrant up --provision | ابدأ وجهز |
vagrant reload --provision | إعادة التشغيل والتجهيز |
أوامر التوفير
| أمر | وصف |
|---|
vagrant up web | ابدأ جهاز محدد |
vagrant ssh web | SSH للاتصال بجهاز محدد |
vagrant halt db | إيقاف آلة محددة |
vagrant destroy --force | دمر الكل بدون تأكيد |
أوامر الآلات المتعددة
| أمر | وصف |
|---|
vagrant snapshot save snapshot_name | احفظ لقطة |
vagrant snapshot list | قائمة اللقطات |
vagrant snapshot restore snapshot_name | استعادة لقطة |
vagrant snapshot delete snapshot_name | احذف اللقطة |
إدارة اللقطات
| أمر | وصف |
|---|
vagrant plugin list | قائمة الإضافات المثبتة |
vagrant plugin install vagrant-vbguest | قم بتثبيت الإضافة |
vagrant plugin uninstall vagrant-vbguest | إلغاء تثبيت البرنامج المساعد |
vagrant plugin update | قم بتحديث جميع الإضافات |
عمليات الإضافات
Vagrant.configure("2") do|config|
config.vm.box = "ubuntu/jammy64"
config.vm.hostname = "myserver"
# Network configuration
config.vm.network "private_network", ip: "192.168.56.10"
config.vm.network "forwarded_port", guest: 80, host: 8080
# Provider configuration
config.vm.provider "virtualbox" do|vb|
vb.memory = "2048"
vb.cpus = 2
vb.name = "MyVM"
end
# Provisioning
config.vm.provision "shell", inline: <<-SHELL
apt-get update
apt-get install -y nginx
systemctl enable nginx
systemctl start nginx
SHELL
end
```## أمثلة Vagrantfile
### Vagrantfile الأساسي
```ruby
Vagrant.configure("2") do|config|
# Web server
config.vm.define "web" do|web|
web.vm.box = "ubuntu/jammy64"
web.vm.hostname = "web"
web.vm.network "private_network", ip: "192.168.56.10"
web.vm.provider "virtualbox" do|vb|
vb.memory = "1024"
vb.cpus = 1
end
web.vm.provision "shell", inline: <<-SHELL
apt-get update
apt-get install -y nginx
SHELL
end
# Database server
config.vm.define "db" do|db|
db.vm.box = "ubuntu/jammy64"
db.vm.hostname = "database"
db.vm.network "private_network", ip: "192.168.56.11"
db.vm.provider "virtualbox" do|vb|
vb.memory = "2048"
vb.cpus = 2
end
db.vm.provision "shell", inline: <<-SHELL
apt-get update
apt-get install -y mysql-server
SHELL
end
end
```### إعداد آلات متعددة
```ruby
Vagrant.configure("2") do|config|
config.vm.box = "ubuntu/jammy64"
config.vm.box_version = "20230607.0.0"
# Synced folders
config.vm.synced_folder ".", "/vagrant", disabled: true
config.vm.synced_folder "./app", "/var/www/html",
owner: "www-data", group: "www-data"
# Network configuration
config.vm.network "private_network",
ip: "192.168.56.10",
netmask: "255.255.255.0"
config.vm.network "public_network",
bridge: "en0: Wi-Fi (AirPort)"
# Port forwarding
config.vm.network "forwarded_port", guest: 80, host: 8080
config.vm.network "forwarded_port", guest: 443, host: 8443
# Provider-specific configuration
config.vm.provider "virtualbox" do|vb|
vb.gui = false
vb.memory = "4096"
vb.cpus = 4
vb.name = "Development Server"
# VirtualBox specific settings
vb.customize ["modifyvm", :id, "--natdnshostresolver1", "on"]
vb.customize ["modifyvm", :id, "--natdnsproxy1", "on"]
end
# Multiple provisioners
config.vm.provision "shell", inline: <<-SHELL
apt-get update
apt-get upgrade -y
SHELL
config.vm.provision "file",
source: "./configs/nginx.conf",
destination: "/tmp/nginx.conf"
config.vm.provision "shell", path: "scripts/setup.sh"
config.vm.provision "ansible" do|ansible|
ansible.playbook = "playbook.yml"
ansible.inventory_path = "inventory"
end
end
```### تكوين متقدم
```ruby
# Inline shell commands
config.vm.provision "shell", inline: <<-SHELL
apt-get update
apt-get install -y docker.io
usermod -aG docker vagrant
SHELL
# External script
config.vm.provision "shell", path: "scripts/bootstrap.sh"
# Privileged and non-privileged
config.vm.provision "shell", privileged: false, inline: <<-SHELL
echo "Running as vagrant user"
SHELL
# Environment variables
config.vm.provision "shell", env: \\\\{"DEBIAN_FRONTEND" => "noninteractive"\\\\}, inline: <<-SHELL
apt-get install -y mysql-server
SHELL
```## طرق التوفير
### التوفير بواسطة Shell
```ruby
config.vm.provision "file",
source: "~/.ssh/id_rsa.pub",
destination: "~/.ssh/authorized_keys"
config.vm.provision "file",
source: "./configs/",
destination: "/tmp/configs"
```### التوفير بواسطة الملفات
```ruby
config.vm.provision "ansible" do|ansible|
ansible.playbook = "site.yml"
ansible.inventory_path = "inventory/vagrant"
ansible.limit = "all"
ansible.verbose = "v"
ansible.extra_vars = \\\\{
nginx_port: 80,
database_name: "myapp"
\\\\}
end
```### التوفير بواسطة Ansible
```ruby
config.vm.provision "docker" do|d|
d.pull_images "nginx"
d.pull_images "mysql:8.0"
d.run "nginx",
args: "-p 80:80 -v /vagrant/html:/usr/share/nginx/html"
d.run "mysql",
args: "-e MYSQL_ROOT_PASSWORD=secret -p 3306:3306"
end
```### التوفير بواسطة Docker
```ruby
# Static IP
config.vm.network "private_network", ip: "192.168.56.10"
# DHCP
config.vm.network "private_network", type: "dhcp"
# Multiple interfaces
config.vm.network "private_network", ip: "192.168.56.10"
config.vm.network "private_network", ip: "10.0.0.10"
```## تكوين الشبكة
### الشبكات الخاصة
```ruby
# Bridge to default interface
config.vm.network "public_network"
# Bridge to specific interface
config.vm.network "public_network", bridge: "en0: Wi-Fi (AirPort)"
# Static IP on public network
config.vm.network "public_network", ip: "192.168.1.100"
Port Forwarding
# Basic port forwarding
config.vm.network "forwarded_port", guest: 80, host: 8080
# Multiple ports
config.vm.network "forwarded_port", guest: 80, host: 8080
config.vm.network "forwarded_port", guest: 443, host: 8443
config.vm.network "forwarded_port", guest: 3306, host: 3306
# Auto-correct port conflicts
config.vm.network "forwarded_port", guest: 80, host: 8080, auto_correct: true
Provider Configuration
VirtualBox Provider
config.vm.provider "virtualbox" do|vb|
vb.gui = true
vb.memory = "4096"
vb.cpus = 4
vb.name = "MyVM"
# Advanced settings
vb.customize ["modifyvm", :id, "--vram", "128"]
vb.customize ["modifyvm", :id, "--accelerate3d", "on"]
vb.customize ["modifyvm", :id, "--clipboard", "bidirectional"]
end
VMware Provider
config.vm.provider "vmware_desktop" do|vmware|
vmware.vmx["memsize"] = "4096"
vmware.vmx["numvcpus"] = "4"
vmware.vmx["displayName"] = "MyVM"
end
Hyper-V Provider
config.vm.provider "hyperv" do|hv|
hv.memory = 4096
hv.cpus = 4
hv.vmname = "MyVM"
end
Synced Folders
Basic Synced Folders
# Default synced folder (disabled)
config.vm.synced_folder ".", "/vagrant", disabled: true
# Custom synced folder
config.vm.synced_folder "./src", "/var/www/html"
# With options
config.vm.synced_folder "./app", "/var/www/html",
owner: "www-data",
group: "www-data",
mount_options: ["dmode=775,fmode=664"]
NFS Synced Folders
config.vm.synced_folder "./", "/vagrant",
type: "nfs",
nfs_udp: false,
nfs_version: 4
SMB Synced Folders (Windows)
config.vm.synced_folder "./", "/vagrant",
type: "smb",
smb_username: "username",
smb_password: "password"
Best Practices
- Resource Allocation: Allocate appropriate CPU and memory
- Synced Folders: Use NFS for better performance on macOS/Linux
- Box Selection: Choose minimal base boxes
- Snapshot Management: Use snapshots for quick rollbacks
- Provider Optimization: Configure provider-specific optimizations
Security
- SSH Keys: Use SSH keys instead of passwords
- Network Isolation: Use private networks when possible
- Firewall: Configure appropriate firewall rules
- Updates: Keep boxes and Vagrant updated
- Secrets: Don’t commit secrets to version control
Development Workflow
- Version Control: Include Vagrantfile in version control
- Documentation: Document setup and usage
- Consistency: Use same environment across team
- Testing: Test provisioning scripts
- Cleanup: Regularly clean up unused VMs and boxes
Troubleshooting
- Logs: Check Vagrant and provider logs
- SSH: Use
vagrant ssh-config for debugging
- Networking: Test network connectivity
- Provisioning: Test provisioning scripts separately
- Resources: Monitor host system resources