Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Buat ROSA dengan HCP cluster menggunakan ROSA CLI
Bagian berikut menjelaskan cara memulai ROSA dengan pesawat kontrol yang dihosting (ROSAdenganHCP) menggunakan AWS STS dan ROSA CLI. Untuk langkah-langkah membuat HCP cluster ROSA with menggunakan Terraform, lihat dokumentasi Red Hat
Bagian ROSA CLImenggunakan auto
mode atau manual
mode untuk membuat IAM sumber daya dan konfigurasi OpenID Connect (OIDC) yang diperlukan untuk membuat ROSA
klaster. auto
mode secara otomatis menciptakan yang diperlukan IAM peran dan kebijakan dan OIDC penyedia. manual
modus output AWS CLI perintah yang diperlukan untuk membuat IAM sumber daya secara manual. Dengan menggunakan manual
mode, Anda dapat meninjau yang dihasilkan AWS CLI perintah sebelum menjalankannya secara manual. Dengan manual
mode, Anda juga dapat meneruskan perintah ke administrator atau grup lain di organisasi Anda sehingga mereka dapat membuat sumber daya.
Prosedur dalam dokumen ini menggunakan auto
mode ROSA CLIuntuk membuat yang dibutuhkan IAM sumber daya dan OIDC konfigurasi untuk ROSA denganHCP. Untuk opsi lainnya untuk memulai, lihatMemulai dengan ROSA.
Topik
- Prasyarat
- Buat Amazon VPC arsitektur
- Buat yang dibutuhkan IAM peran dan konfigurasi OpenID Connect
- Buat ROSA dengan HCP cluster menggunakan ROSA CLIdan AWS STS
- Konfigurasikan penyedia identitas dan berikan klaster akses
- Memberikan akses pengguna ke klaster
- Konfigurasikan cluster-admin izin
- Konfigurasikan dedicated-admin izin
- Akses a klaster melalui Red Hat Hybrid Cloud Console
- Menyebarkan aplikasi dari Katalog Pengembang
- Mencabut cluster-admin izin dari pengguna
- Mencabut dedicated-admin izin dari pengguna
- Mencabut akses pengguna ke klaster
- Hapus klaster dan AWS STS sumber daya
Prasyarat
Lengkapi tindakan prasyarat yang tercantum dalam. Siapkan untuk digunakan ROSA
Buat Amazon VPC arsitektur
Prosedur berikut menciptakan Amazon VPC arsitektur yang dapat digunakan untuk meng-host cluster. Semua klaster sumber daya di-host di subnet pribadi. Subnet publik mengarahkan lalu lintas keluar dari subnet pribadi melalui NAT gateway ke internet publik. Contoh ini menggunakan CIDR blok 10.0.0.0/16
untuk Amazon VPC. Namun, Anda dapat memilih CIDR blok yang berbeda. Untuk informasi lebih lanjut, lihat VPCukuran.
penting
Jika Amazon VPC persyaratan tidak terpenuhi, pembuatan cluster gagal.
Buat yang dibutuhkan IAM peran dan konfigurasi OpenID Connect
Sebelum membuat HCP cluster ROSA with, Anda harus membuat yang diperlukan IAM peran dan kebijakan serta konfigurasi OpenID Connect (OIDC). Untuk informasi lebih lanjut tentang IAM peran dan kebijakan untuk ROSA denganHCP, lihatAWS kebijakan terkelola untuk ROSA.
Prosedur ini menggunakan auto
mode ROSA CLIuntuk secara otomatis membuat OIDC konfigurasi yang diperlukan untuk membuat ROSA dengan HCP cluster.
-
Buat yang dibutuhkan IAM peran dan kebijakan akun.
--force-policy-creation
Parameter memperbarui peran dan kebijakan yang ada. Jika tidak ada peran dan kebijakan yang ada, perintah akan membuat sumber daya ini sebagai gantinya.rosa create account-roles --force-policy-creation
catatan
Jika token akses offline Anda telah kedaluwarsa, ROSA CLImengeluarkan pesan kesalahan yang menyatakan bahwa token otorisasi Anda perlu diperbarui. Untuk langkah-langkah untuk memecahkan masalah, lihat. Memecahkan masalah token akses offline yang ROSA CLI kedaluwarsa
-
Buat konfigurasi OpenID Connect (OIDC) yang memungkinkan otentikasi pengguna ke cluster. Konfigurasi ini terdaftar untuk digunakan dengan OpenShift Cluster Manager (OCM).
rosa create oidc-config --mode=auto
-
Salin ID OIDC konfigurasi yang disediakan di ROSA CLIkeluaran. ID OIDC konfigurasi perlu disediakan nanti untuk membuat HCP cluster ROSA with.
-
Untuk memverifikasi OIDC konfigurasi yang tersedia untuk cluster yang terkait dengan organisasi pengguna Anda, jalankan perintah berikut.
rosa list oidc-config
-
Buat yang dibutuhkan IAM peran operator, diganti
<OIDC_CONFIG_ID>
dengan ID OIDC konfigurasi yang disalin sebelumnya.penting
Anda harus memberikan awalan
<PREFIX_NAME>
saat membuat peran Operator. Gagal melakukannya menghasilkan kesalahan.rosa create operator-roles --prefix <PREFIX_NAME> --oidc-config-id <OIDC_CONFIG_ID> --hosted-cp
-
Untuk memverifikasi IAM peran operator dibuat, jalankan perintah berikut:
rosa list operator-roles
Buat ROSA dengan HCP cluster menggunakan ROSA CLIdan AWS STS
Anda dapat membuat ROSA dengan HCP klaster memakai AWS Security Token Service (AWS STS) dan auto
mode yang disediakan di ROSA CLI. Anda memiliki opsi untuk membuat cluster dengan publik API dan Ingress atau pribadi API dan Ingress.
Anda dapat membuat klaster dengan satu Availability Zone (Single-AZ) atau beberapa Availability Zone (Multi-AZ). Dalam kedua kasus, CIDR nilai mesin Anda harus sesuai dengan CIDR nilai AndaVPC.
Prosedur berikut menggunakan rosa create cluster --hosted-cp
perintah untuk membuat Single-AZ ROSA dengan HCP klaster. Untuk membuat Multi-AZ klaster, tentukan multi-az
dalam perintah dan subnet pribadi IDs untuk setiap subnet pribadi yang ingin Anda terapkan.
-
Buat HCP cluster ROSA with dengan salah satu perintah berikut.
-
Buat HCP cluster ROSA with dengan public API dan Ingress, tentukan nama cluster, awalan peran operator, ID OIDC konfigurasi, dan subnet publik dan pribadi. IDs
rosa create cluster --cluster-name=<CLUSTER_NAME> --sts --mode=auto --hosted-cp --operator-roles-prefix <OPERATOR_ROLE_PREFIX> --oidc-config-id <OIDC_CONFIG_ID> --subnet-ids=<PUBLIC_SUBNET_ID>,<PRIVATE_SUBNET_ID>
-
Buat HCP cluster ROSA with dengan private API dan Ingress, tentukan nama cluster, awalan peran operator, ID OIDC konfigurasi, dan subnet pribadi. IDs
rosa create cluster --private --cluster-name=<CLUSTER_NAME> --sts --mode=auto --hosted-cp --subnet-ids=<PRIVATE_SUBNET_ID>
-
-
Periksa status Anda klaster.
rosa describe cluster -c <CLUSTER_NAME>
catatan
Jika proses pembuatan gagal atau
State
bidang tidak berubah menjadi status siap setelah 10 menit, lihatPemecahan Masalah.Untuk menghubungi AWS Support atau dukungan Red Hat untuk bantuan, lihatMendapatkan ROSA dukungan.
-
Lacak kemajuan klaster pembuatan dengan menonton log OpenShift penginstal.
rosa logs install -c <CLUSTER_NAME> --watch
Konfigurasikan penyedia identitas dan berikan klaster akses
ROSA termasuk OAuth server bawaan. Setelah Anda klaster dibuat, Anda harus mengkonfigurasi OAuth untuk menggunakan penyedia identitas. Anda kemudian dapat menambahkan pengguna ke penyedia identitas yang dikonfigurasi untuk memberi mereka akses ke klaster. Anda dapat memberikan pengguna cluster-admin
atau dedicated-admin
izin ini sesuai kebutuhan.
Anda dapat mengonfigurasi berbagai jenis penyedia identitas untuk ROSA klaster. Jenis yang didukung termasuk GitHub, GitHub Enterprise, GitLab, Google,LDAP, OpenID Connect, dan penyedia HTPasswd identitas.
penting
Penyedia HTPasswd identitas disertakan hanya untuk memungkinkan satu pengguna administrator statis dibuat. HTPasswdtidak didukung sebagai penyedia identitas penggunaan umum untuk ROSA.
Prosedur berikut mengkonfigurasi penyedia GitHub identitas sebagai contoh. Untuk petunjuk tentang cara mengonfigurasi setiap jenis penyedia identitas yang didukung, lihat Mengonfigurasi penyedia identitas untuk AWS STS
-
Arahkan ke github.com
dan masuk ke akun Anda. GitHub -
Jika Anda tidak memiliki GitHub organisasi untuk digunakan untuk penyediaan identitas untuk Anda klaster, buat satu. Untuk informasi selengkapnya, lihat langkah-langkah dalam GitHub dokumentasi
. -
Menggunakan ROSA CLImode interaktif, konfigurasikan penyedia identitas untuk klaster Anda.
rosa create idp --cluster=<CLUSTER_NAME> --interactive
-
Ikuti petunjuk konfigurasi di output untuk membatasi klaster akses ke anggota GitHub organisasi Anda.
I: Interactive mode enabled. Any optional fields can be left empty and a default will be selected. ? Type of identity provider: github ? Identity provider name: github-1 ? Restrict to members of: organizations ? GitHub organizations: <GITHUB_ORG_NAME> ? To use GitHub as an identity provider, you must first register the application: - Open the following URL: https://github.com/organizations/<GITHUB_ORG_NAME>/settings/applications/new?oauth_application%5Bcallback_url%5D=https%3A%2F%2Foauth-openshift.apps.<CLUSTER_NAME>/<RANDOM_STRING>.p1.openshiftapps.com%2Foauth2callback%2Fgithub-1&oauth_application%5Bname%5D=<CLUSTER_NAME>&oauth_application%5Burl%5D=https%3A%2F%2Fconsole-openshift-console.apps.<CLUSTER_NAME>/<RANDOM_STRING>.p1.openshiftapps.com - Click on 'Register application' ...
-
Buka URL di output, ganti
<GITHUB_ORG_NAME>
dengan nama GitHub organisasi Anda. -
Di halaman GitHub web, pilih Daftarkan aplikasi untuk mendaftarkan OAuth aplikasi baru di GitHub organisasi Anda.
-
Gunakan informasi dari GitHub OAuth halaman untuk mengisi prompt
rosa create idp
interaktif yang tersisa dengan menjalankan perintah berikut. Ganti<GITHUB_CLIENT_ID>
dan<GITHUB_CLIENT_SECRET>
dengan kredensi dari aplikasi Anda GitHub OAuth.... ? Client ID: <GITHUB_CLIENT_ID> ? Client Secret: [? for help] <GITHUB_CLIENT_SECRET> ? GitHub Enterprise Hostname (optional): ? Mapping method: claim I: Configuring IDP for cluster '<CLUSTER_NAME>' I: Identity Provider 'github-1' has been created. It will take up to 1 minute for this configuration to be enabled. To add cluster administrators, see 'rosa grant user --help'. To login into the console, open https://console-openshift-console.apps.<CLUSTER_NAME>.<RANDOM_STRING>.p1.openshiftapps.com and click on github-1.
catatan
Mungkin diperlukan waktu sekitar dua menit agar konfigurasi penyedia identitas menjadi aktif. Jika Anda mengonfigurasi
cluster-admin
pengguna, Anda dapat menjalankanoc get pods -n openshift-authentication --watch
untuk melihat OAuth pod di-deploy ulang dengan konfigurasi yang diperbarui. -
Verifikasi bahwa penyedia identitas dikonfigurasi dengan benar.
rosa list idps --cluster=<CLUSTER_NAME>
Memberikan akses pengguna ke klaster
Anda dapat memberikan akses pengguna ke klaster dengan menambahkannya ke penyedia identitas yang dikonfigurasi.
Prosedur berikut menambahkan pengguna ke GitHub organisasi yang dikonfigurasi untuk penyediaan identitas ke cluster.
-
Arahkan ke github.com
dan masuk ke akun Anda. GitHub -
Mengundang pengguna yang membutuhkan klaster akses ke GitHub organisasi Anda. Untuk informasi selengkapnya, lihat Mengundang pengguna untuk bergabung dengan organisasi Anda
dalam GitHub dokumentasi.
Konfigurasikan cluster-admin
izin
-
Berikan
cluster-admin
izin dengan menjalankan perintah berikut. Ganti<IDP_USER_NAME>
dan<CLUSTER_NAME>
dengan nama pengguna dan cluster Anda.rosa grant user cluster-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
-
Verifikasi bahwa pengguna terdaftar sebagai anggota
cluster-admins
grup.rosa list users --cluster=<CLUSTER_NAME>
Konfigurasikan dedicated-admin
izin
-
Berikan
dedicated-admin
izin dengan menggunakan perintah berikut. Ganti<IDP_USER_NAME>
dan<CLUSTER_NAME>
dengan pengguna Anda dan klaster nama dengan menjalankan perintah berikut.rosa grant user dedicated-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
-
Verifikasi bahwa pengguna terdaftar sebagai anggota
cluster-admins
grup.rosa list users --cluster=<CLUSTER_NAME>
Akses a klaster melalui Red Hat Hybrid Cloud Console
Masuk ke Anda klaster melalui Red Hat Hybrid Cloud Console.
-
Dapatkan konsol URL untuk Anda klaster menggunakan perintah berikut. Ganti
<CLUSTER_NAME>
dengan nama Anda klaster.rosa describe cluster -c <CLUSTER_NAME> | grep Console
-
Arahkan ke konsol URL di output dan masuk.
Dalam dialog Masuk dengan..., pilih nama penyedia identitas dan lengkapi permintaan otorisasi yang disajikan oleh penyedia Anda.
Menyebarkan aplikasi dari Katalog Pengembang
Dari Red Hat Hybrid Cloud Console, Anda dapat menerapkan aplikasi pengujian Katalog Pengembang dan mengeksposnya dengan rute.
-
Arahkan ke Red Hat Hybrid Cloud Console
dan pilih cluster tempat Anda ingin menerapkan aplikasi. -
Pada halaman cluster, pilih Open console.
-
Dalam perspektif Administrator, pilih Home > Projects > Create Project.
-
Masukkan nama untuk proyek Anda dan secara opsional tambahkan Nama Tampilan dan Deskripsi.
-
Pilih Buat untuk membuat proyek.
-
Beralih ke perspektif Pengembang dan pilih +Tambah. Pastikan bahwa proyek yang dipilih adalah yang baru saja dibuat.
-
Dalam dialog Katalog Pengembang, pilih Semua layanan.
-
Di halaman Katalog Pengembang, pilih Bahasa > JavaScriptdari menu.
-
Pilih Node.js, lalu pilih Create Application untuk membuka halaman Create Source-to-Image Application.
catatan
Anda mungkin perlu memilih Hapus Semua Filter untuk menampilkan opsi Node.js.
-
Di bagian Git, pilih Coba Sampel.
-
Di bidang Nama, tambahkan nama unik.
-
Pilih Buat.
catatan
Aplikasi baru membutuhkan waktu beberapa menit untuk digunakan.
-
Ketika penyebaran selesai, pilih rute URL untuk aplikasi.
Tab baru di browser terbuka dengan pesan yang mirip dengan berikut ini.
Welcome to your Node.js application on OpenShift
-
(Opsional) Hapus aplikasi dan bersihkan sumber daya:
-
Dalam perspektif Administrator, pilih Home > Projects.
-
Buka menu tindakan untuk proyek Anda dan pilih Hapus Proyek.
-
Mencabut cluster-admin
izin dari pengguna
-
Cabut
cluster-admin
izin menggunakan perintah berikut. Ganti<IDP_USER_NAME>
dan<CLUSTER_NAME>
dengan pengguna Anda dan klaster nama.rosa revoke user cluster-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
-
Verifikasi bahwa pengguna tidak terdaftar sebagai anggota
cluster-admins
grup.rosa list users --cluster=<CLUSTER_NAME>
Mencabut dedicated-admin
izin dari pengguna
-
Cabut
dedicated-admin
izin dengan menggunakan perintah berikut. Ganti<IDP_USER_NAME>
dan<CLUSTER_NAME>
dengan pengguna Anda dan klaster nama.rosa revoke user dedicated-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
-
Verifikasi bahwa pengguna tidak terdaftar sebagai anggota
dedicated-admins
grup.rosa list users --cluster=<CLUSTER_NAME>
Mencabut akses pengguna ke klaster
Anda dapat mencabut klaster akses untuk pengguna penyedia identitas dengan menghapusnya dari penyedia identitas yang dikonfigurasi.
Anda dapat mengonfigurasi berbagai jenis penyedia identitas untuk klaster. Prosedur berikut mencabut klaster akses untuk anggota GitHub organisasi.
-
Arahkan ke github.com
dan masuk ke akun Anda. GitHub -
Hapus pengguna dari GitHub organisasi Anda. Untuk informasi selengkapnya, lihat Menghapus anggota dari organisasi Anda
di GitHub dokumentasi.
Hapus klaster dan AWS STS sumber daya
Anda dapat menggunakan ROSA CLIuntuk menghapus klaster yang menggunakan AWS Security Token Service (AWS STS). Anda juga dapat menggunakan ROSA CLIuntuk menghapus IAM peran dan OIDC penyedia yang dibuat oleh ROSA. Untuk menghapus IAM kebijakan yang dibuat oleh ROSA, Anda dapat menggunakan IAM konsol.
catatan
IAM peran dan kebijakan yang dibuat oleh ROSA dapat digunakan oleh orang lain ROSA cluster di akun yang sama.
-
Hapus klaster dan perhatikan log. Ganti
<CLUSTER_NAME>
dengan nama atau ID Anda klaster.rosa delete cluster --cluster=<CLUSTER_NAME> --watch
penting
Anda harus menunggu klaster untuk menghapus sepenuhnya sebelum Anda menghapus IAM peran, kebijakan, dan OIDC penyedia. IAMPeran akun diperlukan untuk menghapus sumber daya yang dibuat oleh penginstal. IAMPeran operator diperlukan untuk membersihkan sumber daya yang dibuat oleh OpenShift operator. Operator menggunakan OIDC penyedia untuk mengautentikasi.
-
Hapus OIDC penyedia yang klaster operator gunakan untuk mengautentikasi dengan menjalankan perintah berikut.
rosa delete oidc-provider -c <CLUSTER_ID> --mode auto
-
Hapus operator khusus cluster IAM peran.
rosa delete operator-roles -c <CLUSTER_ID> --mode auto
-
Hapus IAM peran akun menggunakan perintah berikut. Ganti
<PREFIX>
dengan awalan IAM peran akun yang akan dihapus. Jika Anda menetapkan awalan kustom saat membuat IAM peran akun, tentukanManagedOpenShift
awalan default.rosa delete account-roles --prefix <PREFIX> --mode auto
-
Hapus IAM kebijakan yang dibuat oleh ROSA.
-
Masuk ke IAM konsol
. -
Di menu sebelah kiri di bawah Manajemen akses, pilih Kebijakan.
-
Pilih kebijakan yang ingin Anda hapus dan pilih Tindakan > Hapus.
-
Masukkan nama kebijakan dan pilih Hapus.
-
Ulangi langkah ini untuk menghapus setiap IAM kebijakan untuk klaster.
-