الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

وكيل أمازون SSM

يعد وكيل Amazon EC2 Simple Systems Manager (SSM) برنامجًا تم تطويره لخدمة Simple Systems Manager Service. يعد عامل SSM هو المكون الأساسي لميزة تسمى "أمر التشغيل".

ملخص

يعمل SSM Agent على مثيلات EC2 ويمكّنك من تنفيذ الأوامر أو البرامج النصية عن بعد بسرعة وسهولة مقابل مثيل واحد أو أكثر. يستخدم الوكيل مستندات SSM. عند تنفيذ أمر، يقوم الوكيل الموجود على المثيل بمعالجة المستند وتكوين المثيل كما هو محدد. حاليًا، يمكّنك الوكيل وأمر التشغيل من تشغيل برامج Shell النصية بسرعة على مثيل باستخدام مستند AWS-RunShellScript SSM. يتيح SSM Agent أيضًا إمكانية إدارة الجلسة التي تتيح لك إدارة مثيل Amazon EC2 الخاص بك من خلال غلاف تفاعلي قائم على المتصفح بنقرة واحدة أو من خلال AWS CLI. في المرة الأولى التي يتم فيها بدء جلسة مدير الجلسة على مثيل، سيقوم الوكيل بإنشاء مستخدم يسمى "ssm-user" مع امتياز sudo أو المسؤول. سيتم إطلاق جلسات مدير الجلسة في سياق هذا المستخدم.

التحقق من المتطلبات

  • المتطلبات الأساسية لأمر تشغيل SSM
  • المتطلبات الأساسية لإدارة جلسة SSM وأنظمة التشغيل المدعومة
  • تتطلب أنظمة Linux إصدار kernel 3.2 أو أعلى

يثبت

  • تكوين أدوار IAM والمستخدمين لأمر تشغيل SSM
  • تكوين وكيل SSM
  • تكوين أدوار IAM لمدير الجلسة
  • تكوين المستخدمين لمدير الجلسة

تنفيذ الأوامر

تجول أمر تشغيل SSM باستخدام AWS CLI

بدء الجلسات

إرشادات مدير الجلسة باستخدام وحدة تحكم AWS وCLI

استكشاف الأخطاء وإصلاحها

استكشاف أخطاء أمر تشغيل SSM وإصلاحها، استكشاف أخطاء مدير جلسة SSM وإصلاحها

تعليق

نشكرك على مساعدتنا في تحسين مدير الأنظمة وتشغيل الأوامر ومدير الجلسة. الرجاء إرسال أسئلتك أو تعليقاتك إلى منتديات مدير الأنظمة

البناء داخل حاوية عامل الإرساء (مستحسن)

  • تثبيت عامل الإرساء: تثبيت CentOS

  • بناء الصورة 

 docker build -t ssm-agent-build-image .
  • بناء الوكيل 
 docker run -it --rm --name ssm-agent-build-container -v `pwd`:/amazon-ssm-agent ssm-agent-build-image make build-release

بناء على لينكس

  • تثبيت اذهب للبدء

  • قم بتثبيت rpm-build وrpmdevtools

  • عبر ترجمة وكيل SSM

  • قم بتشغيل make build لإنشاء SSM Agent لبيئة Linux وDebian وWindows.

  • قم بتشغيل make build-release لإنشاء الوكيل وحزمه أيضًا في حزمة RPM وDEB وZIP.

يتم إنشاء المجلدات التالية عند اكتمال الإنشاء: 

 bin/debian_386
bin/debian_amd64
bin/linux_386
bin/linux_amd64
bin/linux_arm
bin/linux_arm64
bin/windows_386
bin/windows_amd64
  • لتمكين سيناريو Agent for Session Manager على مثيلات Windows
    • استنساخ الريبو من https://github.com/masatma/winpty.git
    • اتبع الإرشادات الموجودة على https://github.com/rprichard/winpty لإنشاء ثنائيات winpty 64 بت
    • انسخ الملفين winpty.dll وwinpty-agent.exe إلى المجلد bin/SessionManagerShell بالنسبة لنظام التشغيل Windows، يتم دعم Session Manager فقط على Windows Server 2008 R2 من خلال إصدارات Windows Server 2019 64 بت.

يرجى اتباع دليل المستخدم لنسخ وكيل SSM وتثبيته

تخطيط الكود

  • كود المصدر
    • الوظائف الأساسية مثل إدارة العمال تقع تحت الأساسية/
    • رمز عامل الوكيل موجود تحت الوكيل/
    • وظائف أخرى مثل IPC تحت المشتركة/
  • كود مصدر حزمة البائع موجود ضمن البائع/src
  • قطع أثرية rpm وdpkg قيد التعبئة
  • توجد البرامج النصية للإنشاء ضمن Tools/src

فحص

لفحص الوحدة بأكملها، قم باستدعاء هدف lint-all . يؤدي هذا إلى تنفيذ golangci-lint على كافة الحزم الموجودة في الوحدة. يمكنك تكوين golangci-lint باستخدام نسالات مختلفة باستخدام ملف .golangci.yml .

للحصول على تعليمات تثبيت golangci-lint، راجع https://golangci-lint.run/usage/install/ لمزيد من المعلومات حول ملف تكوين golangci-lint، راجع https://golangci-lint.run/usage/configuration/ لمزيد من المعلومات حول الوبر المستخدم راجع https://golangci-lint.run/usage/linters/

جوبات

لاستخدام تبعيات البائع، تنسيق GOPATH المقترح هو :/vendor:

جعل الأهداف

الأهداف التالية متاحة. يمكن تشغيل كل منها باستخدام make .

جعل الهدف وصف
build (افتراضي) يقوم build ببناء الوكيل لبيئة Linux وDebian وDarwin وWindows amd64 و386
build-release build-release بالتحقق من نمط التعليمات البرمجية وتغطيتها، وإنشاء الوكيل وتجميعه أيضًا في حزمة RPM وDEB وZIP
release release بالتحقق من نمط الكود وتغطيته، وإجراء الاختبارات، وحزم جميع التبعيات في مجلد سلة المهملات.
package تقوم حزم package ببناء النتيجة في حزمة RPM وDEB وZIP
pre-build تمر pre-build عبر المجلد Tools/src للتأكد من أن كافة ملفات البرامج النصية قابلة للتنفيذ
checkstyle يقوم checkstyle بتشغيل البرنامج النصي checkstyle
analyze-install analyze-install تثبيت تبعيات التحليل الثابت للاستخدام المحلي
analyze يقوم analyze بتشغيل برنامج نصي للتحليل الثابت للعثور على نقاط الضعف المحتملة
quick-integtest يقوم quick-integtest بتشغيل جميع الاختبارات الموسومة بالتكامل باستخدام go test
quick-test يقوم quick-test بإجراء جميع الاختبارات بما في ذلك اختبارات التكامل والوحدة باستخدام go test
coverage تقوم coverage بتشغيل جميع الاختبارات وحساب تغطية الكود
build-linux يقوم build-linux ببناء وكيل للتنفيذ في بيئة Linux amd64
build-windows يقوم build-windows بإنشاء وكيل للتنفيذ في بيئة Windows amd64
build-darwin يقوم build-darwin ببناء وكيل التنفيذ في بيئة Darwin AMD64
build-linux-386 يقوم build-linux-386 بإنشاء وكيل للتنفيذ في بيئة Linux 386
build-windows-386 يقوم build-windows-386 بإنشاء وكيل للتنفيذ في بيئة Windows 386
build-darwin-386 يقوم build-darwin-386 ببناء وكيل التنفيذ في بيئة Darwin 386
build-arm يقوم build-arm ببناء الوكيل للتنفيذ في بيئة الذراع
build-arm64 يقوم build-arm64 ببناء وكيل التنفيذ في بيئة Arm64
lint-all يقوم lint-all بتشغيل golangci-lint على جميع الحزم. تم تكوين golangci-lint بواسطة .golangci.yml
package-rpm تقوم package-rpm بإنشاء الوكيل وتجميعه في حزمة RPM للتوزيعات المستندة إلى Linux amd64
package-deb تقوم package-deb ببناء الوكيل وتجميعه في حزمة DEB للتوزيعات المستندة إلى Debian amd64
package-win تقوم package-win بإنشاء الوكيل وتجميعه في حزمة ZIP للتوزيعات المستندة إلى Windows amd64
package-rpm-386 تقوم package-rpm-386 ببناء الوكيل وتجميعه في حزمة RPM للتوزيعات المستندة إلى Linux 386
package-deb-386 تقوم package-deb-386 ببناء الوكيل وتجميعه في حزمة DEB للتوزيعات المستندة إلى Debian 386
package-win-386 تقوم package-win-386 بإنشاء الوكيل وتجميعه في حزمة ZIP للتوزيعات المستندة إلى Windows 386
package-rpm-arm64 تقوم package-rpm-arm64 ببناء الوكيل وتجميعه في حزمة RPM لتوزيعات تعتمد على Linux Arm64
package-deb-arm تقوم package-deb-arm ببناء الوكيل وتجميعه في توزيعات تعتمد على Debian Arm لحزمة DEB
package-deb-arm64 تقوم package-deb-arm64 ببناء الوكيل وتجميعه في حزمة DEB للتوزيعات المستندة إلى Debian Arm64
package-linux تقوم package-linux بإنشاء حزم تحديث للتوزيعات المستندة إلى Linux وDebian
package-windows تقوم package-windows بإنشاء حزم تحديث للتوزيعات المستندة إلى Windows
package-darwin package-darwin يقوم بإنشاء حزم تحديث للتوزيعات المعتمدة على داروين
get-tools get-tools get على gocode وOracle باستخدام go get
clean clean يزيل آثار البناء

المساهمة

المساهمات وردود الفعل هي موضع ترحيب! سيتم النظر في المقترحات وطلبات السحب والرد عليها. الرجاء مراجعة ملف CONTRIBUTING.md لمزيد من المعلومات.

لا توفر Amazon Web Services حاليًا الدعم للنسخ المعدلة من هذا البرنامج.

تكوين وقت التشغيل

لإعداد التكوين المخصص الخاص بك للوكيل:

  • انتقل إلى /etc/amazon/ssm/ (أو C:Program FilesAmazonSSM لنظام التشغيل Windows)
  • انسخ محتويات amazon-ssm-agent.json.template إلى ملف جديد amazon-ssm-agent.json
  • إعادة تشغيل الوكيل

تعريفات خاصية التكوين:

  • الملف الشخصي - يمثل تكوينات ملف تعريف بيانات اعتماد aws المستخدم للحصول على دور المثيل المُدار وبيانات الاعتماد
    • ShareCreds (منطقي)
      • الافتراضي: صحيح
    • ملف تعريف المشاركة (سلسلة)
    • ForceUpdateCreds (منطقي) - الكتابة فوق ملف بيانات الاعتماد المشترك إذا كان لا يمكن تحليل الملف الموجود
      • الافتراضي: خطأ
    • KeyAutoRotateDays (int) - يحدد الحد الأقصى لعمر المفتاح الخاص الداخلي بالأيام، وقد تتغير القيمة الافتراضية إلى 30 في المستقبل القريب
      • الافتراضي: 0 (لا يتم التدوير مطلقًا)
  • Mds - يمثل تكوين خدمة تسليم الرسائل (MDS) حيث يستمع الوكيل للرسائل الواردة
    • حد عمال الأوامر (int)
      • الافتراضي: 5
    • ستوبتيميوتميليس (int64)
      • الافتراضي: 20000
    • نقطة النهاية (سلسلة)
    • كوماندريتري ليميت (كثافة العمليات)
      • الافتراضي: 15
  • Ssm - يمثل تكوين Simple Systems Manager (SSM)
    • نقطة النهاية (سلسلة)
    • هيلثفريكونسيمينيوتس (كثافة العمليات)
      • الافتراضي: 5
    • CustomInventoryDefaultLocation (سلسلة)
    • سجلات الاقتران، مدة الاحتفاظ، ساعات (int)
      • الافتراضي: 24
    • تشغيلCommandLogsRetentionDurationHours (int)
      • الافتراضي: 336
    • سجل الجلسة، الاحتفاظ، المدة، الساعات (كثافة العمليات)
      • الافتراضي: 336
    • SessionLogsDestination (سلسلة) - قم بتكوين المكان الذي تريد أن يكتب فيه مدير الجلسة بيانات الجلسة.
      • الافتراضي: "لا شيء" - لا تكتب بيانات الجلسة في أي مكان عند تعطيل تسجيل CloudWatch وS3.
      • القيمة الاختيارية: "القرص" - اكتب بيانات الجلسة على القرص.
    • PluginLocalOutputCleanup (سلسلة) - قم بالتكوين عندما يكون من الآمن بعد التنفيذ حذف سجلات إخراج البرنامج المساعد المحلي في مجلد التزامن
      • الافتراضي: "" - لا تحذف السجلات مباشرة بعد التنفيذ. ارجع إلى AssociationLogsRetentionDurationHours وRunCommandLogsRetentionDurationHours وSessionLogsRetentionDurationHours.
      • القيمة الاختيارية: "بعد التنفيذ" - احذف ملف إخراج المكون الإضافي محليًا بعد تنفيذ المكون الإضافي
      • القيمة الاختيارية: "بعد التحميل" - احذف مخرجات المكون الإضافي محليًا بعد نجاح تحميل s3 أو cloudWatch
    • OrchestrationDirectoryCleanup (سلسلة) - يتم تكوينه فقط عندما يكون حذف مجلد التزامن آمنًا بعد تنفيذ المستند. يتجاوز هذا التكوين PluginLocalOutputCleanup عند تعيينه.
      • الافتراضي: "" - لا تحذف مجلد التنسيق بعد التنفيذ
      • القيمة الاختيارية: "نجاح نظيف" - يحذف مجلد التزامن فقط لعمليات تنفيذ المستند الناجحة.
      • القيمة الاختيارية: "فشل نجاح التنظيف" - يحذف مجلد التزامن لعمليات تنفيذ المستندات الناجحة والفاشلة.
  • Mgs - يمثل التكوين لخدمة بوابة الرسائل
    • المنطقة (سلسلة)
    • نقطة النهاية (سلسلة)
    • ستوبتيميوتميليس (int64)
      • الافتراضي: 20000
    • حد عمال الجلسة (int)
      • الافتراضي: 1000
    • DeniedPortForwardingRemoteIPs ([]سلسلة)
      • الافتراضي: [ "169.254.169.254"، "fd00:ec2::254"، "169.254.169.253"، "fd00:ec2::253"، "169.254.169.123"، "fd00:ec2::123"، "169.254" .169.250"، "169.254.169.251"، "fd00:ec2::240"]
  • الوكيل - يمثل البيانات التعريفية لوكيل Amazon-ssm
    • المنطقة (سلسلة)
    • OrchestrationRootDir (سلسلة)
      • الافتراضي: "التنسيق"
    • التحديث الذاتي (منطقي)
      • الافتراضي: خطأ
    • القياس عن بعدMetricsToCloudWatch (منطقي)
      • الافتراضي: خطأ
    • القياس عن بعدMetricsToSSM (منطقي)
      • الافتراضي: صحيح
    • يوم انتهاء الصلاحية (int)
      • الافتراضي: 7
    • LongRunningWorkerMonitorIntervalSeconds (int)
      • الافتراضي: 60
    • GoMaxProcForAgentWorker (كثافة العمليات)
      • الافتراضي: 0
  • نظام التشغيل - يمثل المعلومات ذات الصلة بنظام التشغيل، وسيتم تسجيلها في رسائل الرد
    • لانج (سلسلة)
      • الافتراضي: "ar-US"
    • الاسم (سلسلة)
    • الإصدار (سلسلة)
      • الافتراضي: 1
  • S3 - يمثل التكوينات المتعلقة بحاوية S3 ومفتاح SSM. عادةً ما يتم تحديد نقطة النهاية والمنطقة تلقائيًا، ويجب تعيينهما فقط إذا كانت نقطة النهاية المخصصة مطلوبة. LogBucket وLogKey غير مستخدمين حاليًا.
    • نقطة النهاية (سلسلة)
      • تقصير: ""
    • المنطقة (سلسلة) - تم تجاهلها
    • LogBucket (سلسلة) - تم التجاهل
    • LogKey (سلسلة) - تم التجاهل
  • Kms - يمثل تكوين خدمة إدارة المفاتيح إذا تم تمكين التشفير لهذه الجلسة (أي تم تعيين kmsKeyId أو استخدام البرنامج الإضافي "Port")
    • نقطة النهاية (سلسلة)
    • RequireKMSChallengeResponse (منطقي) - إذا كان صحيحًا، فإنه يفرض أن عملاء مدير الجلسة يدعمون مصادقة الاستجابة والتحدي المحسنة
      • الافتراضي: خطأ

يطلق

بعد إصدار التعليمات البرمجية المصدر لعامل SSM إلى github، قد يستغرق الأمر ما يصل إلى أسبوعين حتى يتم نشر حزم التثبيت في جميع مناطق AWS.

يمكن استخدام الأوامر التالية لسحب ملف VERSION والتحقق من أحدث وكيل متوفر في المنطقة.

  • المجموعة الإقليمية (غير CN ) - curl https://s3.{region}.amazonaws.com/amazon-ssm-{region}/latest/VERSION
    • استبدل {region} برمز المنطقة مثل us-east-1 .
  • المجموعة الإقليمية (CN) - curl https://s3.{region}.amazonaws.com.cn/amazon-ssm-{region}/latest/VERSION
    • استبدل {region} برمز المنطقة cn-north-1 , cn-northwest-1 .
  • الجرافة العالمية - curl https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/VERSION

رخصة

تم ترخيص وكيل Amazon SSM بموجب ترخيص Apache 2.0.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل
تعليقات المستخدمين