View a markdown version of this page

Memecahkan masalah ketersediaan node terkelola - AWS Systems Manager

• AWS Systems Manager CloudWatch Dasbor tidak akan lagi tersedia setelah 30 April 2026. Pelanggan dapat terus menggunakan CloudWatch konsol Amazon untuk melihat, membuat, dan mengelola dasbor Amazon CloudWatch mereka, seperti yang mereka lakukan hari ini. Untuk informasi selengkapnya, lihat dokumentasi CloudWatch Dasbor Amazon.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memecahkan masalah ketersediaan node terkelola

Untuk beberapa AWS Systems Manager alat sepertiRun Command,Distributor, danSession Manager, Anda dapat memilih untuk secara manual memilih node terkelola tempat Anda ingin menjalankan operasi. Dalam kasus seperti ini, setelah Anda menentukan bahwa Anda ingin memilih node secara manual, sistem akan menampilkan daftar node terkelola tempat Anda dapat menjalankan operasi.

Topik ini memberikan informasi untuk membantu Anda mendiagnosis mengapa node terkelola yang telah Anda konfirmasikan sedang berjalan tidak disertakan dalam daftar node terkelola di Manajer Sistem.

Agar node dapat dikelola oleh Manajer Sistem dan tersedia dalam daftar node yang dikelola, node harus memenuhi tiga persyaratan:

  • SSM Agentharus diinstal dan berjalan pada node dengan sistem operasi yang didukung.

    catatan

    Beberapa AWS managed Amazon Machine Images (AMIs) dikonfigurasi untuk meluncurkan instans dengan SSM Agent prainstal. (Anda juga dapat mengonfigurasi kustom AMI untuk pra-instalSSM Agent.) Untuk informasi selengkapnya, lihat Temukan AMI dengan SSM Agent sudah diinstal sebelumnya.

  • Untuk instans Amazon Elastic Compute Cloud (Amazon EC2), Anda harus melampirkan profil instans AWS Identity and Access Management (IAM) ke instans. Profil instance memungkinkan instance untuk berkomunikasi dengan layanan Manajer Sistem. Jika Anda tidak menetapkan profil instance ke instans, Anda mendaftarkannya menggunakan aktivasi hibrida, yang bukan skenario umum.

  • SSM Agentharus dapat terhubung ke titik akhir Manajer Sistem untuk mendaftarkan dirinya dengan layanan. Setelah itu, node yang dikelola harus tersedia untuk layanan, yang dikonfirmasi oleh layanan mengirimkan sinyal setiap lima menit untuk memeriksa kesehatan instance.

  • Setelah status node terkelola setidaknya Connection Lost selama 30 hari, node mungkin tidak lagi terdaftar di Fleet Manager konsol. Untuk mengembalikannya ke daftar, masalah yang menyebabkan koneksi hilang harus diselesaikan.

Setelah memverifikasi bahwa node terkelola sedang berjalan, Anda dapat menggunakan perintah berikut untuk memeriksa apakah SSM Agent berhasil terdaftar dengan layanan Manajer Sistem. Perintah ini tidak mengeluarkan hasil hingga pendaftaran berhasil dilakukan.

Linux & macOS
aws ssm describe-instance-associations-status \ --instance-id instance-id
Windows
aws ssm describe-instance-associations-status ^ --instance-id instance-id
PowerShell
Get-SSMInstanceAssociationsStatus ` -InstanceId instance-id

Jika pendaftaran berhasil dan node terkelola sekarang tersedia untuk operasi Manajer Sistem, perintah mengembalikan hasil yang mirip dengan berikut ini.

{
    "InstanceAssociationStatusInfos": [
        {
            "AssociationId": "fa262de1-6150-4a90-8f53-d7eb5EXAMPLE",
            "Name": "AWS-GatherSoftwareInventory",
            "DocumentVersion": "1",
            "AssociationVersion": "1",
            "InstanceId": "i-02573cafcfEXAMPLE",
            "Status": "Pending",
            "DetailedStatus": "Associated"
        },
        {
            "AssociationId": "f9ec7a0f-6104-4273-8975-82e34EXAMPLE",
            "Name": "AWS-RunPatchBaseline",
            "DocumentVersion": "1",
            "AssociationVersion": "1",
            "InstanceId": "i-02573cafcfEXAMPLE",
            "Status": "Queued",
            "AssociationName": "SystemAssociationForScanningPatches"
        }
    ]
}

Jika pendaftaran belum selesai atau gagal, perintah tersebut mengeluarkan hasil yang serupa dengan berikut ini:

{
    "InstanceAssociationStatusInfos": []
}

Jika perintah tidak mengembalikan hasil setelah 5 menit atau lebih, gunakan informasi berikut untuk membantu Anda memecahkan masalah dengan node terkelola Anda.

Solusi 1: Verifikasi SSM Agent diinstal dan berjalan pada node yang dikelola

Pastikan versi terbaru diinstal dan berjalan pada node yang dikelola. SSM Agent

Untuk menentukan SSM Agent apakah diinstal dan berjalan pada node terkelola, lihatMemeriksa SSM Agent status dan memulai agen.

Untuk menginstal atau menginstal ulang SSM Agent pada node terkelola, lihat topik berikut:

Solusi 2: Verifikasi bahwa profil instans IAM telah ditentukan untuk instans (hanya instans EC2)

Untuk instans Amazon Elastic Compute Cloud (Amazon EC2), verifikasi bahwa instance dikonfigurasi dengan profil instans AWS Identity and Access Management (IAM) yang memungkinkan instans berkomunikasi dengan System Manager API. Juga verifikasi bahwa pengguna Anda memiliki kebijakan kepercayaan IAM yang memungkinkan pengguna Anda berkomunikasi dengan API Manajer Sistem.

catatan

On-premises server, perangkat tepi, dan mesin virtual (VM) menggunakan peran layanan IAM alih-alih profil instance. Untuk informasi selengkapnya, lihat Membuat peran layanan IAM yang diperlukan untuk Manajer Sistem di lingkungan hybrid dan multicloud.

Untuk menentukan apakah profil instance dengan izin yang diperlukan dilampirkan ke instans EC2
  1. Buka konsol Amazon EC2 di https://console.aws.amazon.com/ec2/.

  2. Di panel navigasi, pilih Instans.

  3. Pilih instans untuk memeriksa profil instans.

  4. Di tab Deskripsi di panel bawah, temukan IAM role dan pilih nama peran.

  5. Di halaman Ringkasan peran untuk profil instans, di tab Izin, pastikan bahwa AmazonSSMManagedInstanceCore tercantum di bawah Kebijakan izin.

    Jika kebijakan kustom digunakan sebagai gantinya, pastikan bahwa kebijakan tersebut menyediakan izin yang sama seperti AmazonSSMManagedInstanceCore.

    Buka AmazonSSMManagedInstanceCore di konsol

    Untuk informasi tentang kebijakan lain yang dapat dilampirkan ke profil instance untuk Manajer Sistem, lihat Meng onfigurasi izin instans yang diperlukan untuk Manajer Sistem.

Solusi 3: Verifikasi konektivitas titik akhir layanan

Verifikasi bahwa instans memiliki konektivitas ke titik akhir layanan Systems Manager. Konektivitas ini disediakan dengan membuat dan mengonfigurasi titik akhir VPC untuk Systems Manager, atau dengan mengizinkan lalu lintas keluar HTTPS (port 443) ke titik akhir layanan.

Untuk instans Amazon EC2, titik akhir layanan Manaj Wilayah AWS er Sistem digunakan untuk mendaftarkan instans jika konfigurasi virtual private cloud (VPC) memungkinkan lalu lintas keluar. Namun, jika konfigurasi VPC tempat instance diluncurkan tidak mengizinkan lalu lintas keluar dan Anda tidak dapat mengubah konfigurasi ini untuk mengizinkan konektivitas ke titik akhir layanan publik, Anda harus mengonfigurasi titik akhir antarmuka untuk VPC Anda sebagai gantinya.

Untuk informasi selengkapnya, lihat Meningkatkan keamanan instans EC2 dengan menggunakan titik akhir VPC untuk Manajer Sistem.

Solusi 4: Verifikasi dukungan sistem operasi target

Verifikasi bahwa operasi yang telah Anda pilih dapat dijalankan pada jenis node terkelola yang Anda harapkan akan ditampilkan. Beberapa operasi Systems Manager hanya dapat menargetkan instans Windows atau hanya instans Linux. Misalnya, dokumen Systems Manager (SSM) AWS-InstallPowerShellModule dan AWS-ConfigureCloudWatch hanya dapat dijalankan di instans Windows saja. Di halaman Jalankan perintah, jika Anda memilih salah satu dari dokumen ini dan memilih Pilih instans secara manual, hanya instans Windows Anda yang tercantum dan tersedia untuk dipilih.

Solusi 5: Pastikan Anda bekerja di tempat yang sama Wilayah AWS sebagai instans Amazon EC2

Instans Amazon EC2 dibuat dan tersedia di wilayah tertentu Wilayah AWS, seperti Wilayah AS Timur (Ohio) (us-east-2) atau Wilayah Eropa (Irlandia) (eu-west-1). Pastikan Anda bekerja Wilayah AWS sama dengan instans Amazon EC2 yang ingin Anda gunakan. Untuk informasi selengkapnya, lihat Memilih Wilayah dalam Memulai dengan Konsol Manajemen AWS.

Solusi 6: Verifikasi konfigurasi proxy yang Anda terapkan SSM Agent pada node terkelola

Pastikan konfigurasi proxy yang Anda terapkan SSM Agent pada node terkelola sudah benar. Jika konfigurasi proxy salah, node tidak dapat terhubung ke titik akhir layanan yang diperlukan, atau Manajer Sistem mungkin mengidentifikasi sistem operasi dari node yang dikelola secara tidak benar. Untuk informasi selengkapnya, lihat Melakukan konfigurasi SSM Agent untuk menggunakan proxy pada node Linux dan SSM AgentKonfigurasikan untuk menggunakan proxy untuk Windows Server instance.

Solusi 7: Menginstal sertifikat TLS pada instans terkelola

Sertifikat Transport Layer Security (TLS) harus diinstal pada setiap instans terkelola yang Anda gunakan. AWS Systems Manager Layanan AWS gunakan sertifikat ini untuk mengenkripsi panggilan ke orang lain Layanan AWS.

Sertifikat TLS sudah diinstal secara default pada setiap instans Amazon EC2 dibuat dari Amazon Machine Image (AMI). Sebagian besar sistem operasi modern termasuk sertifikat TLS yang diperlukan dari Amazon Trust Services CAs berada di penyimpanan terpercayaan mereka.

Untuk memverifikasi apakah sertifikat yang diperlukan diinstal pada instans Anda, jalankan perintah berikut berdasarkan sistem operasi instans Anda. Pastikan untuk mengganti region bagian URL dengan Wilayah AWS tempat instance terkelola Anda berada.

Linux & macOS
curl -L https://ssm.region.amazonaws.com
Windows
Invoke-WebRequest -Uri https://ssm.region.amazonaws.com

Perintah harus mengembalikan UnknownOperationException kesalahan. Jika Anda menerima pesan SSL/TLS kesalahan sebagai gantinya maka sertifikat yang diperlukan mungkin tidak diinstal.

Jika Anda menemukan sertifikat CA Amazon Trust Services yang diperlukan tidak diinstal pada sistem operasi dasar Anda, pada instans yang dibuat dari AMIs yang tidak disediakan oleh Amazon, atau di server dan VM lokal Anda sendiri, Anda harus menginstal dan mengizinkan sertifikat dari Amazon Trust Services, atau menggunakan AWS Certificate Manager (ACM) untuk membuat dan mengelola sertifikat untuk layanan terintegrasi yang didukung.

Setiap instans terkelola Anda harus memiliki salah satu sertifikat Transport Layer Security (TLS) berikut yang diinstal.

  • Amazon Root CA 1

  • Starfield Services Root Certificate Authority - G2

  • Starfield Class 2 Certificate Authority

Untuk informasi tentang cara menggunakan ACM, lihat Panduan Pengguna AWS Certificate Manager.

Jika sertifikat di lingkungan komputasi dikelola oleh objek kebijakan grup (GPO), maka Anda mungkin perlu mengkonfigurasi kebijakan grup untuk menyertakan salah satu sertifikat ini.

Untuk informasi lebih lanjut tentang sertifikat Amazon Root dan Starfield, lihat posting blog Cara Mempersiapkan Pindah ke AWS Otoritas Sertifikat Sendiri.