عن المشروع

doctl هي واجهة سطر الأوامر الرسمية لـ DigitalOcean API. تعرض موارد سحابة DigitalOcean من خلال أوامر فرعية، بحيث يمكن سرد البنية التحتية وإنشاؤها وإدارتها من الطرفية بدلاً من لوحة التحكم. تغطي مجموعات الأوامر التطبيقات بنقرة واحدة، تفاصيل الحساب، التطبيقات، المصادقة، الرصيد، سجل الفوترة، الحوسبة (البنية التحتية مثل Droplets والنطاقات وعناوين IP العائمة وجدران الحماية وموازنات التحميل والتخزين الكتلي)، قواعد البيانات، الفواتير، مجموعات Kubernetes والتكوينات، المراقبة (موسومة كنسخة تجريبية)، المشاريع، سجلات الحاويات والشبكات الافتراضية. يولد أمر الإكمال نصوص إكمال تلقائي للصدفة، ويبلغ أمر الإصدار عن البناء المثبت. تتضمن العلامات العامة رمز وصول، تجاوز عنوان API، ملف تكوين مخصص، اسم سياق مصادقة، اختيار تنسيق الإخراج بين نص وJSON، تتبع نشاط الشبكة، وإخراج مفصّل. تشمل خيارات التثبيت مديري الحزم مثل Homebrew على macOS وSnap ومستودعات Arch Linux وFedora وNixpkgs، بالإضافة إلى صور Docker Hub وأرشيفات الإصدارات المبنية مسبقًا من GitHub والبناء من المصدر مع بيئة Go. تُوسم الإصدارات التجريبية بشكل منفصل ويمكن تثبيتها باستخدام go install أو بناؤها من المصدر أو تنزيلها كأرشيفات مبنية مسبقًا؛ يثبت مديرو الحزم إصدارات التوفر العام فقط. تستخدم المصادقة رمز وصول DigitalOcean يتم إنشاؤه في لوحة التحكم. يخزن أمر auth init بيانات الاعتماد وينشئ ملف التكوين. يتم دعم حسابات متعددة من خلال سياقات مصادقة مسماة، مع سياق افتراضي والقدرة على التبديل أو التجاوز لكل أمر. تنطبق علامة رمز الوصول ومتغير البيئة فقط على السياق الافتراضي. يُخزن التكوين في ملف config.yaml خاص بالمنصة، ويمكن تعيين قيم العلامات الافتراضية هناك باستخدام تنسيق category.command.sub-command.flag، على سبيل المثال لتغيير مستخدم SSH الافتراضي. يمكن لمتغيرات البيئة مثل DIGITALOCEAN_CONTEXT وDIGITALOCEAN_ACCESS_TOKEN تجاوز الإعدادات لجلسة عمل. يتوفر الإكمال التلقائي للصدفة لـ Bash وZSH وfish، وليس على Windows. تُقدم تعليمات إلغاء التثبيت لـ Homebrew، بما في ذلك إزالة دليل التكوين. تعرض الأمثلة في README سرد وإنشاء Droplets، وتعيين عنوان IP عائم، وإنشاء سجل DNS من النوع A، والاتصال عبر SSH باسم Droplet مع مستخدم اختياري. يربط README أيضًا بوثائق مرجعية كاملة ودروس مجتمعية تغطي موازنات التحميل وجدران الحماية السحابية والتخزين الكتلي.