Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan apa yang dimaksud dengan profil instance IAM AWS, mengapa profil ini penting dalam konteks GKE di AWS, dan cara memperbarui profil instance.
Apa yang dimaksud dengan profil instance IAM AWS?
Profil instance adalah konsep khusus AWS. Terdiri dari serangkaian
kredensial yang digunakan instance Amazon EC2 untuk mengakses berbagai resource AWS.
Lebih khusus lagi, profil instance adalah jenis penampung untuk peran IAM yang dapat dilampirkan ke instance EC2. Profil instance memberikan izin
ke instance EC2, sehingga instance dapat berinteraksi dengan berbagai layanan AWS
berdasarkan izin yang ditentukan. Untuk mengetahui informasi selengkapnya, lihat
Menggunakan profil instance.
Bagaimana cara menggunakan profil instance di GKE di AWS?
Setiap bidang kontrol dan setiap node pool dalam cluster GKE di AWS
dikaitkan dengan profil instance AWS yang unik. Profil instance di
GKE di AWS memiliki dua tujuan:
Profil instance memberikan izin yang diperlukan GKE di AWS untuk mengelola resource AWS. Misalnya, mereka memberikan izin yang diperlukan kepada autoscaler cluster untuk menskalakan cluster dengan menambahkan atau menghapus instance EC2 berdasarkan permintaan beban kerja.
Profil instance memberikan akses instance EC2 ke Google Cloud layanan.
Misalnya, kubelet, yang berjalan di komputer AWS, memerlukan izin khusus untuk menyediakan kredensial penarikan image ke containerd. Kredensial ini diperlukan untuk mengakses dan menarik image dari Artifact Registry pribadi Google atau dari Container Registry. Dalam konteks GKE di AWS, profil instance EC2 yang terkait dengan cluster dikonfigurasi untuk meniru Agen Layanan Mesin Google (seperti Agen Layanan Mesin Node Pool atau Agen Layanan Mesin Control Plane). Peniruan identitas ini memungkinkan instance EC2 cluster untuk mengautentikasi secara otomatis dengan Artifact Registry atau Container Registry Google.
Memperbarui profil instance
Memperbarui profil instance melibatkan pembuatan profil instance baru di AWS dengan izin tertentu, lalu mengaitkannya dengan cluster atau node pool GKE di AWS.
Untuk memperbarui profil instance cluster atau node pool dengan benar, ikuti langkah-langkah berikut:
Buat profil instance IAM untuk instance Amazon EC2 Anda dan tambahkan
peran IAM yang Anda butuhkan ke profil instance. Untuk mengetahui detailnya, lihat
Menggunakan profil instance.
Tautkan profil instance baru ke cluster atau kumpulan node GKE di AWS dengan menjalankan perintah berikut di Google Cloud CLI:
NEW_INSTANCE_PROFILE_NAME: nama profil instance AWS baru yang Anda buat
Perintah ini hanya menampilkan flag yang relevan untuk memperbarui profil instance, tetapi Anda perlu memberikan flag tambahan untuk menjalankan perintah update. Untuk mengetahui detailnya, lihat
Memperbarui parameter cluster AWS Anda atau
Memperbarui node pool.
Metode update yang salah
Memahami cara yang salah untuk memperbarui profil instance sangat penting, karena
kesalahan ini mudah dilakukan dan dapat menyebabkan kegagalan cluster.
Cara yang salah untuk memperbarui profil instance adalah dengan mengubah profil instance yang ada secara langsung menggunakan AWS Management Console atau AWS CLI. Perubahan tersebut dapat mengganggu interaksi GKE di AWS dengan resource AWS. GKE di AWS
mengharapkan profil instance tetap seperti saat pertama kali ditautkan ke
cluster atau kumpulan node. Mengubahnya di luar alat pengelolaan GKE di AWS dapat menyebabkan ketidakcocokan dengan ID peran IAM yang ada di profil instance. Ketidakcocokan ini dapat menyebabkan kegagalan cluster.
Pendekatan yang dijelaskan di bagian sebelumnya memastikan bahwa update dilakukan tanpa mengganggu integrasi GKE di AWS dengan AWS.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-31 UTC."],[],[],null,["# Update AWS IAM instance profile\n\nThis page explains what an AWS IAM instance profile is, why it's important in\nthe context of GKE on AWS, and how to update the instance profile.\n\nWhat is an AWS IAM instance profile?\n------------------------------------\n\nAn instance profile is an AWS-specific concept. It consists of a set of\ncredentials that an Amazon EC2 instance uses to access various AWS resources.\nMore specifically, an instance profile is a kind of container for an IAM role\nthat can be attached to an EC2 instance. An instance profile confers permissions\nto the EC2 instance, allowing the instance to interact with various AWS services\nunder the defined permissions. For more information, see\n[Using instance profiles](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html).\n\nHow are instance profiles used in GKE on AWS?\n---------------------------------------------\n\nEach control plane and each node pool within a GKE on AWS cluster\nis associated with a unique AWS instance profile. Instance profiles in\nGKE on AWS serve a dual purpose:\n\n1. An instance profile grants GKE on AWS the permissions needed to manage AWS resources. For example, they give the cluster autoscaler the necessary permissions to scale the cluster by adding or removing EC2 instances based on workload demands.\n2. An instance profile grants EC2 instances access to Google Cloud services. For example the `kubelet`, running on an AWS machine, requires specific permissions to supply image pull credentials to `containerd`. These credentials are necessary for accessing and pulling images from Google's private Artifact Registry or from Container Registry. In the context of GKE on AWS, the EC2 instance profile associated with the cluster is configured to impersonate Google's Machine Service Agents (such as the Node Pool Machine Service Agent or the Control Plane Machine Service Agent). This impersonation allows the cluster's EC2 instances to automatically authenticate with Google's Artifact Registry or Container Registry.\n\nUpdate instance profile\n-----------------------\n\nUpdating the instance profile involves creating a new instance profile in AWS\nwith specific permissions, and then associating it with your\nGKE on AWS cluster or node pool.\n\nTo correctly update the instance profile for your cluster or node pool, follow\nthese steps:\n\n1. Create an IAM instance profile for your Amazon EC2 instances and add the IAM role you need to the instance profile. For details, see [Using instance profiles](https://docs.aws.amazon.com/codedeploy/latest/userguide/getting-started-create-iam-instance-profile.html).\n2. Link the new instance profile to your GKE on AWS cluster or node\n pool by running the following command in your Google Cloud CLI:\n\n ### Link profile to cluster\n\n gcloud container aws clusters update \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e \\\n --update-instance-profile \\\n --instance-profile-name \u003cvar translate=\"no\"\u003eNEW_INSTANCE_PROFILE_NAME\u003c/var\u003e \\\n ...\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e: the name of your cluster\n - \u003cvar translate=\"no\"\u003eNEW_INSTANCE_PROFILE_NAME\u003c/var\u003e: the name of the new AWS instance profile you created\n\n ### Link profile to node pool\n\n gcloud container aws node-pools update \u003cvar translate=\"no\"\u003eNODE_POOL_NAME\u003c/var\u003e \\\n --update-instance-profile \\\n --instance-profile-name \u003cvar translate=\"no\"\u003eNEW_INSTANCE_PROFILE_NAME\u003c/var\u003e \\\n ...\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eNODE_POOL_NAME\u003c/var\u003e: the name of your node pool\n - \u003cvar translate=\"no\"\u003eNEW_INSTANCE_PROFILE_NAME\u003c/var\u003e: the name of the new AWS instance profile you created\n\n These commands show only the relevant flags for updating the instance\n profile, but you need to provide additional flags in order to run the\n `update` command. For details, see\n [Update your AWS cluster parameters](/kubernetes-engine/multi-cloud/docs/aws/how-to/update-cluster) or\n [Update a node pool](/kubernetes-engine/multi-cloud/docs/aws/how-to/update-node-pool).\n\n### The incorrect update method\n\nUnderstanding the wrong way to update an instance profile is important, because\nit's an easy mistake to make that can cause cluster failures.\n\nThe wrong way to update an instance profile is to directly modify an existing\ninstance profile using the AWS Management Console or AWS CLI. Such changes can\ndisrupt GKE on AWS interaction with AWS resources. GKE on AWS\nexpects instance profiles to remain as they were when first linked to the\ncluster or node pool. Altering them outside of GKE on AWS's management\ntools can create a mismatch with the ID of the IAM role that's in the instance\nprofile. This mismatch can create a cluster failure.\n\nThe approach described in the preceding section ensures that updates are made\nwithout disrupting GKE on AWS's integration with AWS."]]
