หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>ซอร์สโค้ดอื่น ๆ
ดาวน์โหลด

ตัวแทน Amazon SSM

Amazon EC2 Simple Systems Manager (SSM) Agent เป็นซอฟต์แวร์ที่พัฒนาขึ้นสำหรับ Simple Systems Manager Service SSM Agent เป็นส่วนประกอบหลักของคุณสมบัติที่เรียกว่า Run Command

ภาพรวม

SSM Agent ทำงานบนอินสแตนซ์ EC2 และช่วยให้คุณสามารถรันคำสั่งหรือสคริปต์ระยะไกลกับหนึ่งอินสแตนซ์ขึ้นไปได้อย่างรวดเร็วและง่ายดาย เอเจนต์ใช้เอกสาร SSM เมื่อคุณดำเนินการคำสั่ง เอเจนต์บนอินสแตนซ์จะประมวลผลเอกสารและกำหนดค่าอินสแตนซ์ตามที่ระบุไว้ ในปัจจุบัน เอเจนต์และ Run Command ช่วยให้คุณสามารถรันสคริปต์ Shell บนอินสแตนซ์ได้อย่างรวดเร็วโดยใช้เอกสาร AWS-RunShellScript SSM SSM Agent ยังเปิดใช้งานความสามารถของ Session Manager ที่ช่วยให้คุณจัดการอินสแตนซ์ Amazon EC2 ของคุณผ่านเชลล์บนเบราว์เซอร์แบบโต้ตอบเพียงคลิกเดียวหรือผ่าน AWS CLI ครั้งแรกที่เซสชัน Session Manager เริ่มต้นบนอินสแตนซ์ เอเจนต์จะสร้างผู้ใช้ชื่อ "ผู้ใช้ ssm" ด้วยสิทธิ์ sudo หรือผู้ดูแลระบบ เซสชันตัวจัดการเซสชันจะเปิดตัวในบริบทของผู้ใช้รายนี้

ตรวจสอบข้อกำหนด

  • ข้อกำหนดเบื้องต้นของคำสั่ง SSM Run
  • ข้อกำหนดเบื้องต้นของ SSM Session Manager และระบบปฏิบัติการที่รองรับ
  • ระบบ Linux ต้องการเคอร์เนลเวอร์ชัน 3.2 ขึ้นไป

ตั้งค่า

  • การกำหนดค่าบทบาท IAM และผู้ใช้สำหรับ SSM Run Command
  • การกำหนดค่าตัวแทน SSM
  • การกำหนดค่าบทบาท IAM สำหรับตัวจัดการเซสชัน
  • การกำหนดค่าผู้ใช้สำหรับตัวจัดการเซสชัน

การดำเนินการคำสั่ง

บทสรุปการเรียกใช้คำสั่ง SSM โดยใช้ AWS CLI

กำลังเริ่มเซสชัน

บทสรุป Session Manager โดยใช้คอนโซล AWS และ CLI

การแก้ไขปัญหา

การแก้ไขปัญหาคำสั่งเรียกใช้ SSM การแก้ไขปัญหาตัวจัดการเซสชัน SSM

ข้อเสนอแนะ

ขอขอบคุณที่ช่วยเราปรับปรุง Systems Manager, Run Command และ Session Manager กรุณาส่งคำถามหรือความคิดเห็นของคุณไปที่ฟอรัมผู้จัดการระบบ

สร้างภายในคอนเทนเนอร์นักเทียบท่า (แนะนำ)

  • ติดตั้งนักเทียบท่า: ติดตั้ง 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

สร้างบน Linux

  • ติดตั้งไปเริ่มต้นใช้งาน

  • ติดตั้ง 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
  • เพื่อเปิดใช้งานสถานการณ์ตัวแทนสำหรับตัวจัดการเซสชันบนอินสแตนซ์ Windows
    • โคลน repo จาก 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 Agent

เค้าโครงโค้ด

  • ซอร์สโค้ด
    • ฟังก์ชันหลัก เช่น การจัดการผู้ปฏิบัติงานอยู่ภายใต้หลัก/
    • รหัสพนักงานตัวแทนอยู่ภายใต้ตัวแทน/
    • ฟังก์ชันอื่นๆ เช่น IPC อยู่ภายใต้การใช้งานทั่วไป/
  • ซอร์สโค้ดแพ็คเกจของผู้ขายอยู่ภายใต้ vendor/src
  • สิ่งประดิษฐ์ rpm และ dpkg อยู่ภายใต้การบรรจุ
  • สคริปต์ build อยู่ภายใต้ Tools/src

ผ้าสำลี

หากต้องการ lint ทั้งโมดูลให้เรียก lint-all target สิ่งนี้จะรัน golangci-lint บนแพ็คเกจทั้งหมดในโมดูล คุณสามารถกำหนดค่า golangci-lint ด้วย linters ที่แตกต่างกันได้โดยใช้ไฟล์ .golangci.yml

สำหรับคำแนะนำในการติดตั้ง golangci-lint โปรดดู https://golangci-lint.run/usage/install/ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับไฟล์การกำหนดค่า golangci-lint โปรดดู https://golangci-lint.run/usage/configuration/ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ linters ที่ใช้ดู 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 จะตรวจสอบรูปแบบโค้ดและความครอบคลุม รันการทดสอบ ทำแพ็กเกจการขึ้นต่อกันทั้งหมดไปยังโฟลเดอร์ bin
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 สร้างเอเจนต์สำหรับการดำเนินการในสภาพแวดล้อมแบบ 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 สร้างเอเจนต์และทำแพ็กเกจลงในแพ็คเกจ DEB การแจกแจงแบบ Debian arm
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 รับ 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 ที่ใช้เพื่อรับบทบาทอินสแตนซ์ที่ได้รับการจัดการและข้อมูลประจำตัว
    • แชร์Creds (boolean)
      • ค่าเริ่มต้น: จริง
    • แชร์โปรไฟล์ (สตริง)
    • ForceUpdateCreds (บูลีน) - เขียนทับไฟล์ข้อมูลรับรองที่แชร์ หากไฟล์ที่มีอยู่ไม่สามารถแยกวิเคราะห์ได้
      • ค่าเริ่มต้น: เท็จ
    • KeyAutoRotateDays (int) - กำหนดอายุสูงสุดเป็นจำนวนวันสำหรับคีย์ส่วนตัวในองค์กร ค่าเริ่มต้นอาจเปลี่ยนเป็น 30 ในอนาคตอันใกล้นี้
      • ค่าเริ่มต้น: 0 (ไม่ต้องหมุน)
  • Mds - แสดงถึงการกำหนดค่าสำหรับบริการส่งข้อความ (MDS) โดยที่ตัวแทนรับฟังข้อความขาเข้า
    • CommandWorkersLimit (int)
      • ค่าเริ่มต้น: 5
    • StopTimeoutMillis (int64)
      • ค่าเริ่มต้น: 20000
    • จุดสิ้นสุด (สตริง)
    • CommandRetryLimit (int)
      • ค่าเริ่มต้น: 15
  • Ssm - แสดงถึงการกำหนดค่าสำหรับ Simple Systems Manager (SSM)
    • จุดสิ้นสุด (สตริง)
    • HealthFrequencyMinutes (int)
      • ค่าเริ่มต้น: 5
    • CustomInventoryDefaultLocation (สตริง)
    • AssociationLogsRetentionDurationHours (int)
      • ค่าเริ่มต้น: 24
    • RunCommandLogsRetentionDurationHours (int)
      • ค่าเริ่มต้น: 336
    • SessionLogsRetentionDurationHours (int)
      • ค่าเริ่มต้น: 336
    • SessionLogsDestination (สตริง) - กำหนดค่าตำแหน่งที่คุณต้องการให้ Session Manager เขียนข้อมูลเซสชัน
      • ค่าเริ่มต้น: "ไม่มี" - ห้ามเขียนข้อมูลเซสชันใดๆ เมื่อปิดใช้งานการบันทึก CloudWatch และ S3
      • OptionalValue: "disk" - เขียนข้อมูลเซสชันลงดิสก์
    • PluginLocalOutputCleanup (สตริง) - กำหนดค่าเมื่อหลังจากดำเนินการแล้ว จะปลอดภัยที่จะลบบันทึกเอาต์พุตปลั๊กอินในเครื่องในโฟลเดอร์ orchestration
      • ค่าเริ่มต้น: "" - อย่าลบบันทึกทันทีหลังจากดำเนินการ ย้อนกลับไปที่ AssociationLogsRetentionDurationHours, RunCommandLogsRetentionDurationHours และ SessionLogsRetentionDurationHours
      • OptionalValue: "after-execution" - ลบไฟล์เอาต์พุตปลั๊กอินในเครื่องหลังจากเรียกใช้ปลั๊กอิน
      • OptionalValue: "after-upload" - ลบเอาต์พุตปลั๊กอินในเครื่องหลังจากอัปโหลด s3 หรือ cloudWatch สำเร็จ
    • OrchestrationDirectoryCleanup (สตริง) - กำหนดค่าเฉพาะเมื่อปลอดภัยที่จะลบโฟลเดอร์ orchestration หลังจากดำเนินการเอกสาร การกำหนดค่านี้จะแทนที่ PluginLocalOutputCleanup เมื่อตั้งค่า
      • ค่าเริ่มต้น: "" - อย่าลบโฟลเดอร์ orchestration หลังจากดำเนินการ
      • OptionalValue: "clean-success" - ลบโฟลเดอร์ orchestration สำหรับการดำเนินการเอกสารที่สำเร็จเท่านั้น
      • OptionalValue: "clean-success-failed" - ลบโฟลเดอร์ orchestration สำหรับการดำเนินการเอกสารที่สำเร็จและล้มเหลว
  • Mgs - แสดงถึงการกำหนดค่าสำหรับบริการ Message Gateway
    • ภูมิภาค (สตริง)
    • จุดสิ้นสุด (สตริง)
    • StopTimeoutMillis (int64)
      • ค่าเริ่มต้น: 20000
    • SessionWorkersLimit (int)
      • ค่าเริ่มต้น: 1,000
    • 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"]
  • Agent - แสดงถึงข้อมูลเมตาสำหรับ amazon-ssm-agent
    • ภูมิภาค (สตริง)
    • OrchestrationRootDir (สตริง)
      • ค่าเริ่มต้น: "การจัดเรียบเรียง"
    • การอัปเดตตนเอง (บูลีน)
      • ค่าเริ่มต้น: เท็จ
    • TelemetryMetricsToCloudWatch (บูลีน)
      • ค่าเริ่มต้น: เท็จ
    • TelemetryMetricsToSSM (บูลีน)
      • ค่าเริ่มต้น: จริง
    • วันหมดอายุการตรวจสอบ (int)
      • ค่าเริ่มต้น: 7
    • LongRunningWorkerMonitorIntervalSeconds (int)
      • ค่าเริ่มต้น: 60
    • GoMaxProcForAgentWorker (int)
      • ค่าเริ่มต้น: 0
  • Os - หมายถึงข้อมูลที่เกี่ยวข้องกับระบบปฏิบัติการ จะถูกบันทึกไว้ในข้อความตอบกลับ
    • ลาง (สตริง)
      • ค่าเริ่มต้น: "en-US"
    • ชื่อ (สตริง)
    • เวอร์ชัน (สตริง)
      • ค่าเริ่มต้น: 1
  • S3 - แสดงถึงการกำหนดค่าที่เกี่ยวข้องกับบัคเก็ต S3 และคีย์สำหรับ SSM โดยทั่วไปจุดสิ้นสุดและภูมิภาคจะถูกกำหนดโดยอัตโนมัติ และควรตั้งค่าเมื่อจำเป็นต้องใช้จุดสิ้นสุดที่กำหนดเองเท่านั้น LogBucket และ LogKey ไม่ได้ใช้งานอยู่ในขณะนี้
    • จุดสิ้นสุด (สตริง)
      • ค่าเริ่มต้น: ""
    • ภูมิภาค (สตริง) - ละเว้น
    • LogBucket (สตริง) - ละเว้น
    • LogKey (สตริง) - ละเว้น
  • Kms - แสดงถึงการกำหนดค่าสำหรับบริการการจัดการคีย์ หากมีการเปิดใช้งานการเข้ารหัสสำหรับเซสชันนี้ (เช่น มีการตั้งค่า kmsKeyId หรือใช้ปลั๊กอิน "พอร์ต")
    • จุดสิ้นสุด (สตริง)
    • RequireKMSChallengeResponse (บูลีน) - หากเป็นจริง บังคับใช้ว่าไคลเอ็นต์ตัวจัดการเซสชันสนับสนุนการรับรองความถูกต้องการตอบสนองต่อความท้าทายที่ได้รับการปรับปรุง
      • ค่าเริ่มต้น: เท็จ

ปล่อย

หลังจากที่ซอร์สโค้ด SSM Agent ได้รับการเผยแพร่ไปยัง GitHub อาจใช้เวลาถึง 2 สัปดาห์ก่อนที่แพ็คเกจการติดตั้งจะเผยแพร่ไปยังภูมิภาค 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 Agent ได้รับอนุญาตภายใต้ Apache 2.0 License

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด
ความคิดเห็นจากผู้ใช้