Bantu meningkatkan halaman ini
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Untuk berkontribusi pada panduan pengguna ini, pilih GitHub tautan Edit halaman ini di yang terletak di panel kanan setiap halaman.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Memulai dengan Amazon EKS — Konsol Manajemen AWS and AWS CLI
catatan
Topik ini mencakup memulai tanpa Mode Otomatis EKS. Ini menggunakan Grup Node Terkelola untuk menyebarkan node.
Mode Otomatis EKS mengotomatiskan tugas rutin untuk komputasi cluster, penyimpanan, dan jaringan. Pelajari cara memulai dengan Mode Otomatis Amazon EKS. Mode Otomatis EKS adalah metode yang disukai untuk menerapkan node.
Panduan ini membantu Anda membuat semua sumber daya yang diperlukan untuk memulai Amazon Elastic Kubernetes Service (Amazon EKS) menggunakan Konsol Manajemen AWS dan CLI. AWS Dalam panduan ini, Anda membuat setiap sumber daya secara manual. Di akhir tutorial, Anda akan memiliki klaster Amazon EKS yang sudah berjalan yang dapat digunakan sebagai tempat men-deploy aplikasi.
Prosedur dalam panduan ini memberikan visibilitas lengkap tentang bagaimana setiap sumber daya dibuat dan bagaimana mereka berinteraksi satu sama lain. Jika Anda lebih suka membuat sebagian besar sumber daya untuk Anda secara otomatis, gunakan eksctl CLI untuk membuat cluster dan node Anda. Untuk informasi selengkapnya, lihat Memulai dengan Amazon EKS — eksctl.
Prasyarat
Sebelum memulai tutorial ini, Anda harus menginstal dan mengonfigurasi alat-alat dan sumber daya yang Anda butuhkan berikut untuk membuat dan mengelola sebuah klaster Amazon EKS.
-
AWS CLI — Alat baris perintah untuk bekerja dengan AWS layanan, termasuk Amazon EKS. Untuk informasi selengkapnya, lihat Menginstal di Panduan AWS Pengguna Antarmuka Baris Perintah. Setelah menginstal AWS CLI, kami sarankan Anda juga mengkonfigurasinya. Untuk informasi selengkapnya, lihat Konfigurasi cepat dengan aws configure di Panduan Pengguna AWS Antarmuka Baris Perintah. Perhatikan bahwa AWS CLI v2 diperlukan untuk menggunakan opsi update-kubeconfig yang ditampilkan di halaman ini.
-
kubectl— Alat baris perintah untuk bekerja dengan cluster Kubernetes. Untuk informasi selengkapnya, lihat Siapkan kubectl dan eksctl . -
Izin IAM yang diperlukan — Prinsip keamanan IAM yang Anda gunakan harus memiliki izin untuk bekerja dengan peran IAM Amazon EKS, peran terkait layanan, VPC AWS CloudFormation, dan sumber daya terkait. Untuk informasi selengkapnya, lihat T ind akan dan Menggunakan peran terkait layanan di Panduan Pengguna IAM. Anda harus menyelesaikan semua langkah dalam panduan ini sebagai pengguna yang sama. Untuk memeriksa pengguna saat ini, jalankan perintah berikut:
aws sts get-caller-identity
Kami menyarankan Anda menyelesaikan langkah-langkah dalam topik ini di shell Bash. Jika Anda tidak menggunakan shell Bash, beberapa perintah skrip seperti karakter kelanjutan baris dan cara variabel diatur dan digunakan memerlukan penyesuaian untuk shell Anda. Selain itu, aturan kutipan dan pelarian untuk shell Anda mungkin berbeda. Untuk informasi selengkapnya, lihat Menggunakan tanda kutip dengan string di AWS CLI di Panduan Pengguna Antar AWS muka Baris Perintah.
Langkah 1: Buat klaster dan Amazon EKS Anda
penting
Untuk memulai sesederhana dan secepat mungkin, topik ini mencakup langkah-langkah untuk membuat cluster dengan pengaturan default. Sebelum membuat cluster untuk penggunaan produksi, sebaiknya Anda membiasakan diri dengan semua pengaturan dan menyebarkan cluster dengan pengaturan yang memenuhi persyaratan Anda. Untuk informasi selengkapnya, lihat Membuat cluster Amazon EKS. Beberapa pengaturan hanya dapat diaktifkan saat membuat cluster Anda.
-
Buat Amazon VPC dengan subnet publik dan privat yang memenuhi persyaratan Amazon EKS. Ganti
region-codedengan Wil AWS ayah apa pun yang didukung oleh Amazon EKS. Untuk daftar Wil AWS ayah, lihat titik akhir dan kuota Amazon EKS di panduan Refer AWS ensi Umum. Anda dapat menggantimy-eks-vpc-stackdengan nama apa pun yang Anda pilih.aws cloudformation create-stack \ --regionregion-code\ --stack-name my-eks-vpc-stack \ --template-url https://s3.us-west-2.amazonaws.com/amazon-eks/cloudformation/2020-10-29/amazon-eks-vpc-private-subnets.yamlTip
Untuk daftar semua sumber daya yang dibuat perintah sebelumnya, buka AWS CloudFormation konsol di https://console.aws.amazon.com/cloudformation/. Pilih
my-eks-vpc-stacktumpukan dan kemudian pilih tab Resources. -
Membuat IAM role klaster dan lampirkan kebijakan terkelola Amazon EKS IAM ke dalam peran itu. Cluster Kubernetes yang dikelola oleh Amazon EKS melakukan panggilan ke AWS layanan lain atas nama Anda untuk mengelola sumber daya yang Anda gunakan dengan layanan.
-
Salin isi berikut ke file bernama
eks-cluster-role-trust-policy.json.{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "eks.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } -
Buat peran.
aws iam create-role \ --role-name myAmazonEKSClusterRole \ --assume-role-policy-document file://"eks-cluster-role-trust-policy.json" -
Lampirkan kebijakan terkelola IAM Amazon EKS yang diperlukan untuk peran tersebut.
aws iam attach-role-policy \ --policy-arn arn:aws: iam::aws:policy/AmazonEKSClusterPolicy \ --role-name myAmazonEKSClusterRole
-
-
Buka konsol Amazon EKS di https://console.aws.amazon.com/eks/home #/cluster
. Pastikan bahwa Wil AWS ayah yang ditampilkan di kanan atas konsol Anda adalah AWS Wilayah tempat Anda ingin membuat cluster. Jika tidak, pilih dropdown di sebelah nama Wil AWS ayah dan pilih Wil AWS ayah yang ingin Anda gunakan.
-
Pilih Buat klaster. Jika Anda tidak melihat opsi ini, pilih Cluster di panel navigasi kiri terlebih dahulu.
-
Pada halaman Konfigurasi cluster, lakukan hal berikut:
-
Pilih Konfigur asi kustom dan nonaktifkan Gunakan Mode Otomatis EKS. (Jika Anda lebih suka cluster Mode Otomatis EKS, lihat sajaBuat Cluster Mode Otomatis EKS dengan Konsol Manajemen AWS.)
-
Masukkan Nama untuk cluster Anda, seperti
my-cluster. Nama hanya dapat berisi karakter alfanumerik (peka huruf besar/kecil) dan tanda hubung. Itu harus dimulai dengan karakter alfanumerik dan tidak boleh lebih dari 100 karakter. Nama harus unik dalam Wil AWS ayah dan AWS akun tempat Anda membuat cluster. -
Untuk Peran Layanan Cluster, pilih
myAmazonEKSClusterRole. -
Biarkan pengaturan yang tersisa pada nilai defaultnya dan pilih Ber ikutnya.
-
-
Pada halaman Tentukan jaringan, lakukan hal berikut:
-
Pilih ID VPC yang Anda buat pada langkah sebelumnya dari daftar dropdown VPC. Ini adalah sesuatu seperti
* | my-eks-vpc-stack-VPC. -
Pilih subnet yang dibuat pada langkah sebelumnya dari daftar dropdown Subnet. Subnet akan menjadi sesuatu seperti
* | my-eks-vpc-stack-*. -
Pilih grup keamanan yang dibuat pada langkah sebelumnya dari daftar dropdown Grup keamanan tambahan. Ini adalah sesuatu seperti
* | my-eks-vpc-stack-ControlPlaneSecurityGroup-*. -
Biarkan pengaturan yang tersisa pada nilai defaultnya dan pilih Ber ikutnya.
-
-
Pada halaman Konfigurasi observabilitas, pilih Ber ikutnya.
-
Pada halaman Pilih add-on, pilih Ber ikutnya.
Untuk informasi selengkapnya tentang add-on, lihatAdd-on Amazon EKS.
-
Pada halaman Konfigurasikan pengaturan add-on yang dipilih, pilih Ber ikutnya.
-
Pada halaman Tinjau dan buat, pilih Buat.
Di sebelah kanan nama cluster, status cluster adalah Membuat selama beberapa menit sampai proses penyediaan cluster selesai. Jangan lanjutkan ke langkah berikutnya sampai statusnya Aktif.
catatan
Anda mungkin menerima kesalahan bahwa salah satu Zona Ketersediaan dalam permintaan Anda tidak memiliki kapasitas yang cukup untuk membuat cluster Amazon EKS. Jika hal ini terjadi, output galat berisi Availability Zones yang dapat mendukung klaster baru. Cobalah untuk kembali membuat klaster dengan setidaknya dua subnet yang terletak di Availability Zones yang didukung untuk akun Anda. Untuk informasi selengkapnya, lihat Kapasitas tidak mencukupi.
Langkah 2: Hubungkan ke cluster Anda
Di bagian ini, Anda terhubung kubectl ke cluster Anda sehingga Anda dapat mengelola sumber daya Kubernetes.
Sebelum melanjutkan, pastikan bahwa pembuatan cluster Anda berhasil diselesaikan di Langkah 1.
Opsi 1: Hubungkan menggunakan AWS CLI
-
Buat atau perbarui file
kubeconfiguntuk klaster Anda. Gantiregion-codedengan AWS Wilayah tempat Anda membuat cluster Anda. Gantimy-clusterdengan nama klaster Anda.aws eks update-kubeconfig --regionregion-code--namemy-clusterSecara default,
configfile dibuat di~/.kubeatau konfigurasi cluster baru ditambahkan keconfigfile yang ada di~/.kube. -
Uji konfigurasi Anda.
kubectl get svccatatan
Jika Anda menerima kesalahan jenis otorisasi atau sumber daya, lihat topik Tidak sah atau akses ditolak (kubectl) pemecahan masalah.
Contoh output adalah sebagai berikut.
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE svc/kubernetes ClusterIP 10.100.0.1 <none> 443/TCP 1m
Opsi 2: Hubungkan menggunakan konsol EKS
Atau, Anda dapat terhubung langsung dari konsol tanpa pengaturan lokal:
-
Pada halaman detail cluster untuk cluster yang Anda buat di Langkah 1, pilih Hubun gkan.
-
AWS CloudShell terbuka dengan
kubectlpra-konfigurasi untuk cluster Anda. -
Uji koneksi Anda:
kubectl get svc
Untuk informasi selengkapnya, lihat Hubungkan kubectl ke cluster EKS dengan membuat file kubeconfig.
Langkah 3: Buat node
penting
Untuk memulai sesederhana dan secepat mungkin, topik ini mencakup langkah-langkah untuk membuat node dengan sebagian besar pengaturan default. Sebelum membuat node untuk penggunaan produksi, kami sarankan Anda membiasakan diri dengan semua pengaturan dan menerapkan node dengan pengaturan yang memenuhi kebutuhan Anda. Untuk informasi selengkapnya, lihat Mengelola sumber daya komputasi dengan menggunakan simpul. Beberapa pengaturan hanya dapat diaktifkan saat membuat node Anda.
Prosedur ini mengonfigurasi cluster Anda untuk menggunakan grup node terkelola untuk membuat node, menentukan subnet dan peran IAM node yang Anda buat pada langkah sebelumnya. Ini memungkinkan Anda menjalankan aplikasi Amazon Linux pada instans Amazon EC2.
Untuk mempelajari lebih lanjut tentang berbagai cara untuk mengkonfigurasi node di EKS, lihatMengelola sumber daya komputasi dengan menggunakan simpul. Setelah klaster Anda di-deploy, Anda dapat menambahkan jenis simpul lainnya. Meskipun tidak tercantum dalam panduan ini, Anda juga dapat menambahkan simpul Windows swakelola dan Bottlerocket ke klaster Anda.
Untuk membuat grup node terkelola EC2 Linux Anda
-
Buat IAM role simpul dan lampirkan kebijakan terkelola Amazon EKS IAM ke dalam peran itu.
kubeletDaemon node Amazon EKS melakukan panggilan ke AWS API atas nama Anda. Simpul menerima izin untuk panggilan API ini melalui profil instans IAM dan kebijakan terkait.-
Salin konten berikut ke file bernama
node-role-trust-policy.json.{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } -
Buat IAM role simpul.
aws iam create-role \ --role-name myAmazonEKSNodeRole \ --assume-role-policy-document file://"node-role-trust-policy.json" -
Lampirkan kebijakan IAM terkelola yang diperlukan ke peran tersebut.
aws iam attach-role-policy \ --policy-arn arn:aws: iam::aws:policy/AmazonEKSWorkerNodePolicy \ --role-name myAmazonEKSNodeRole aws iam attach-role-policy \ --policy-arn arn:aws: iam::aws:policy/AmazonEC2ContainerRegistryReadOnly \ --role-name myAmazonEKSNodeRole aws iam attach-role-policy \ --policy-arn arn:aws: iam::aws:policy/AmazonEKS_CNI_Policy \ --role-name myAmazonEKSNodeRole -
Buka konsol Amazon EKS di https://console.aws.amazon.com/eks/home #/cluster
. -
Pilih nama cluster yang Anda buat di Langkah 1: Buat cluster Amazon EKS Anda, seperti
my-cluster. -
Pada
my-clusterhalaman, lakukan hal berikut: -
Pilih tab Compute.
-
Pilih Tambahkan Grup Node.
-
-
Pada halaman Configure Node Group, lakukan hal berikut:
-
Untuk Nama, masukkan nama unik untuk grup node terkelola Anda, seperti
my-nodegroup. Nama grup node tidak boleh lebih dari 63 karakter. Itu harus dimulai dengan huruf atau digit, tetapi juga dapat menyertakan tanda hubung dan garis bawah untuk karakter yang tersisa. -
Untuk nama peran Node IAM, pilih
myAmazonEKSNodeRoleperan yang Anda buat pada langkah sebelumnya. Kami menyarankan agar setiap grup node menggunakan peran IAM uniknya sendiri. -
Pilih Berikutnya.
-
-
Pada halaman Set el konfigurasi komputasi dan penskalaan, terima nilai default dan pilih Ber ikutnya.
-
Pada halaman Tentukan jaringan, terima nilai default dan pilih Ber ikutnya.
-
Pada halaman Tinjauan dan buat, tinjau konfigurasi grup simpul terkelola dan pilih Buat.
-
Setelah beberapa menit, Status di bagian Konfigurasi Grup simpul akan berubah dari Sedang membuat ke Aktif. Jangan lanjutkan ke langkah berikutnya sampai statusnya Aktif.
Langkah 4: Lihat sumber daya
Anda dapat melihat simpul dan beban kerja Kubernetes Anda.
-
Pada panel navigasi sebelah kiri, pilih Klaster. Dalam daftar Cluster, pilih nama cluster yang Anda buat, seperti
my-cluster. -
Pada
my-clusterhalaman, pilih yang berikut ini:-
Tab Compute — Anda melihat daftar Node yang digunakan untuk cluster. Anda dapat memilih nama node untuk melihat informasi lebih lanjut tentangnya.
-
Tab Resources — Anda melihat semua sumber daya Kubernetes yang digunakan secara default ke cluster Amazon EKS. Pilih jenis sumber daya apa pun di konsol untuk mempelajari lebih lanjut tentangnya.
-
Langkah 5: Hapus sumber daya
Setelah Anda selesai dengan cluster dan node yang Anda buat untuk tutorial ini, Anda harus menghapus sumber daya yang Anda buat. Jika Anda ingin melakukan lebih banyak dengan cluster ini sebelum menghapus sumber daya, lihatLangkah selanjutnya.
-
Hapus grup simpul atau profil Fargate yang Anda buat.
-
Buka konsol Amazon EKS di https://console.aws.amazon.com/eks/home #/cluster
. -
Pada panel navigasi sebelah kiri, pilih Klaster. Dalam daftar cluster, pilih
my-cluster. -
Pilih tab Compute.
-
Jika Anda membuat grup node, pilih grup
my-nodegroupnode dan kemudian pilih H apus. Masukkanmy-nodegroup, lalu pilih Hapus. -
Jangan lanjutkan sampai profil grup node dihapus.
-
-
Hapus klaster .
-
Pada panel navigasi sebelah kiri, pilih Klaster. Dalam daftar cluster, pilih
my-cluster. -
Pilih Hapus cluster.
-
Masukkan
my-clusterdan kemudian pilih H apus. Jangan lanjutkan sampai cluster dihapus.
-
-
Hapus tumpukan V AWS CloudFormation PC yang Anda buat.
-
Buka CloudFormation konsol di https://console.aws.amazon.com/cloudformation/.
-
Pilih tum
my-eks-vpc-stackpukan, lalu pilih H apus. -
Di kotak dialog Hapus
my-eks-vpc-stackkonfirmasi, pilih H apus tumpukan.
-
-
Hapus IAM role yang Anda buat.
-
Buka konsol IAM di https://console.aws.amazon.com/iam/.
-
Di panel navigasi sebelah kiri, pilih Peran.
-
Pilih setiap peran yang Anda buat dari daftar (
myAmazonEKSClusterRole, sertamyAmazonEKSNodeRole). Pilih Hapus, masukkan teks konfirmasi yang diminta, lalu pilih H apus.
-
Langkah selanjutnya
Topik dokumentasi berikut membantu Anda untuk memperluas fungsionalitas klaster Anda.
-
Prinsi p IAM yang membuat cluster adalah satu-satunya prinsipal yang dapat melakukan panggilan ke server API Kubernetes dengan atau.
kubectlKonsol Manajemen AWS Jika Anda ingin prinsipal IAM lainnya memiliki akses ke cluster Anda, maka Anda perlu menambahkannya. Untuk informasi selengkapnya, lihat Berikan akses kepada pengguna dan peran IAM ke API Kubernetes dan Izin yang diperlukan. -
Menyebarkan aplikasi sampel ke cluster Anda.
-
Sebelum menerapkan cluster untuk penggunaan produksi, sebaiknya Anda membiasakan diri dengan semua pengaturan untuk cluster dan node. Beberapa pengaturan (seperti mengaktifkan akses SSH ke node Amazon EC2) harus dibuat saat cluster dibuat.
-
Untuk meningkatkan keamanan cluster Anda, konfigurasikan plugin Amazon VPC Container Networking Interface untuk menggunakan peran IAM untuk akun layanan.