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

# Buat cluster klasik ROSA menggunakan CLI ROSA
<a name="getting-started-classic-cli"></a>

Bagian berikut menjelaskan cara memulai menggunakan ROSA klasik AWS STS dan ROSA CLI. Untuk langkah-langkah membuat klaster klasik ROSA menggunakan Terraform, lihat dokumentasi [Red Hat](https://docs.openshift.com/rosa/rosa_install_access_delete_clusters/terraform/rosa-classic-creating-a-cluster-quickly-terraform.html). Untuk mempelajari lebih lanjut tentang penyedia Terraform untuk membuat ROSA cluster, lihat dokumentasi Terraform[.](https://registry.terraform.io/providers/terraform-redhat/rhcs/latest/docs)

 ROSA CLI menggunakan `auto` mode atau `manual` mode untuk membuat IAM sumber daya yang diperlukan untuk menyediakan a. ROSA klaster`auto`mode segera membuat IAM peran dan kebijakan yang diperlukan dan penyedia OpenID Connect (OIDC). `manual`mode output AWS CLI perintah yang diperlukan untuk membuat IAM sumber daya. Dengan menggunakan `manual` mode, Anda dapat meninjau AWS CLI perintah yang dihasilkan 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.

Untuk opsi lainnya untuk memulai, lihat[Memulai dengan ROSA](getting-started.md).

**Topics**
+ [Prasyarat](#getting-started-classic-cli-prereqs)
+ [Buat cluster klasik ROSA menggunakan ROSA CLI dan AWS STS](#create-rosa-classic-cluster-cli-sts)
+ [Konfigurasikan penyedia identitas dan berikan klaster akses](#getting-started-classic-cli-configure-oidc)
+ [Memberikan akses pengguna ke klaster](#getting-started-classic-cli-grant-user-access)
+ [Mengatur Konfigurasi Izin `cluster-admin`](#configure-cluster-admin-classic-cli)
+ [Mengatur Konfigurasi Izin `dedicated-admin`](#configure-dedicated-admin-classic-cli)
+ [Akses klaster melalui Red Hat Hybrid Cloud Console](#console-access-classic-cli)
+ [Menyebarkan aplikasi dari Katalog Pengembang](#deploy-app-classic-cli)
+ [Mencabut `cluster-admin` izin dari pengguna](#revoke-cluster-admin-classic-cli)
+ [Mencabut `dedicated-admin` izin dari pengguna](#revoke-dedicated-admin-classic-cli)
+ [Mencabut akses pengguna ke klaster](#revoke-user-classic-cli)
+ [Hapus klaster dan AWS STS sumber daya](#delete-cluster-classic-cli)

## Prasyarat
<a name="getting-started-classic-cli-prereqs"></a>

Lengkapi tindakan prasyarat yang tercantum dalam. [Siapkan untuk digunakan ROSA](set-up.md)

## Buat cluster klasik ROSA menggunakan ROSA CLI dan AWS STS
<a name="create-rosa-classic-cluster-cli-sts"></a>

Anda dapat membuat ROSA klasik klaster menggunakan ROSA AWS STS CLI dan.

1. Buat peran dan kebijakan IAM akun yang diperlukan menggunakan `--mode auto` atau`--mode manual`.
   + 

     ```
     rosa create account-roles --classic --mode auto
     ```
   + 

     ```
     rosa create account-roles --classic --mode manual
     ```
**catatan**  
Jika token akses offline Anda telah kedaluwarsa, ROSA CLI mengeluarkan pesan kesalahan yang menyatakan bahwa token otorisasi Anda perlu diperbarui. Untuk langkah-langkah untuk memecahkan masalah, lihat. [Memecahkan masalah ROSA CLI token akses offline kedaluwarsa](troubleshooting-rosa.md#rosa-cli-expired-token)

1. Buat klaster menggunakan `--mode auto` atau`--mode manual`. `auto`mode memungkinkan Anda untuk membuat cluster lebih cepat. `manual`modus meminta Anda untuk menentukan pengaturan kustom untuk cluster Anda.
   + 

     ```
     rosa create cluster --cluster-name <CLUSTER_NAME> --sts --mode auto
     ```
**catatan**  
Saat Anda menentukan`--mode auto`, `rosa create cluster` perintah akan membuat IAM peran operator khusus cluster dan penyedia OIDC secara otomatis. Operator menggunakan penyedia OIDC untuk mengautentikasi.
**catatan**  
Saat menggunakan `--mode auto` default, OpenShift versi stabil terbaru diinstal.
   + 

     ```
     rosa create cluster --cluster-name <CLUSTER_NAME> --sts --mode manual
     ```
**penting**  
Jika Anda mengaktifkan enkripsi etcd dalam `manual` mode, Anda akan dikenakan overhead kinerja sekitar 20%. Overhead adalah hasil dari memperkenalkan lapisan enkripsi kedua ini, selain enkripsi Amazon EBS default yang mengenkripsi volume etcd.
**catatan**  
Setelah menjalankan `manual` mode untuk membuat cluster, Anda perlu membuat peran IAM operator khusus cluster secara manual dan penyedia OpenID Connect yang digunakan operator klaster untuk mengautentikasi.

1. Periksa status Anda klaster.

   ```
   rosa describe cluster -c <CLUSTER_NAME>
   ```
**catatan**  
Jika proses penyediaan gagal atau `State` bidang tidak berubah menjadi status siap setelah 40 menit, lihat. [Pemecahan Masalah](troubleshooting-rosa.md) Untuk menghubungi Dukungan atau dukungan Red Hat untuk bantuan, lihat[Mendapatkan ROSA dukungan](rosa-support.md).

1. Lacak kemajuan klaster pembuatan dengan menonton log OpenShift penginstal.

   ```
   rosa logs install -c <CLUSTER_NAME> --watch
   ```

## Konfigurasikan penyedia identitas dan berikan klaster akses
<a name="getting-started-classic-cli-configure-oidc"></a>

 ROSA termasuk OAuth server bawaan. Setelah klaster dibuat, Anda harus mengonfigurasi OAuth untuk menggunakan penyedia identitas. Anda kemudian dapat menambahkan pengguna ke penyedia identitas yang dikonfigurasi untuk memberi mereka akses ke layanan Anda klaster. Anda dapat memberikan pengguna `cluster-admin` atau `dedicated-admin` izin ini sesuai kebutuhan.

Anda dapat mengonfigurasi berbagai jenis penyedia identitas untuk Anda ROSA klaster. Jenis yang didukung termasuk GitHub, GitHub Enterprise, GitLab, Google, LDAP, OpenID Connect HTPasswd , dan penyedia identitas.

**penting**  
Penyedia HTPasswd identitas disertakan hanya untuk memungkinkan satu pengguna administrator statis dibuat. HTPasswd tidak 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](https://access.redhat.com/documentation/en-us/red_hat_openshift_service_on_aws/4/html/install_rosa_classic_clusters/rosa-sts-config-identity-providers).

1. Arahkan ke [github.com](https://github.com/) dan masuk ke akun Anda. GitHub 

1. 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](https://docs.github.com/en/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch).

1. Menggunakan mode interaktif ROSA CLI, konfigurasikan penyedia identitas untuk klaster Anda.

   ```
   rosa create idp --cluster=<CLUSTER_NAME> --interactive
   ```

1. Ikuti petunjuk konfigurasi di output untuk membatasi klaster akses ke anggota organisasi Anda GitHub .

   ```
   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'
   ...
   ```

1. Buka URL di output, ganti `<GITHUB_ORG_NAME>` dengan nama GitHub organisasi Anda.

1. Di halaman GitHub web, pilih **Daftarkan aplikasi** untuk mendaftarkan OAuth aplikasi baru di GitHub organisasi Anda.

1. 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 kredensil 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 menjalankan `oc get pods -n openshift-authentication --watch` untuk melihat OAuth pod di-deploy ulang dengan konfigurasi yang diperbarui.

1. Verifikasi bahwa penyedia identitas dikonfigurasi dengan benar.

   ```
   rosa list idps --cluster=<CLUSTER_NAME>
   ```

## Memberikan akses pengguna ke klaster
<a name="getting-started-classic-cli-grant-user-access"></a>

Anda dapat memberikan akses pengguna ke Anda klaster dengan menambahkannya ke penyedia identitas yang dikonfigurasi.

Prosedur berikut menambahkan pengguna ke GitHub organisasi yang dikonfigurasi untuk penyediaan identitas ke cluster.

1. Arahkan ke [github.com](https://github.com/) dan masuk ke akun Anda. GitHub 

1. Undang pengguna yang memerlukan klaster akses ke GitHub organisasi Anda. Untuk informasi selengkapnya, lihat [Mengundang pengguna untuk bergabung dengan organisasi Anda](https://docs.github.com/en/organizations/managing-membership-in-your-organization/inviting-users-to-join-your-organization) dalam GitHub dokumentasi.

## Mengatur Konfigurasi Izin `cluster-admin`
<a name="configure-cluster-admin-classic-cli"></a>

1. 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>
   ```

1. Verifikasi bahwa pengguna terdaftar sebagai anggota `cluster-admins` grup.

   ```
   rosa list users --cluster=<CLUSTER_NAME>
   ```

## Mengatur Konfigurasi Izin `dedicated-admin`
<a name="configure-dedicated-admin-classic-cli"></a>

1. Berikan `dedicated-admin` izin dengan menggunakan perintah berikut. Ganti `<IDP_USER_NAME>` dan `<CLUSTER_NAME>` dengan pengguna dan klaster nama Anda dengan menjalankan perintah berikut.

   ```
   rosa grant user dedicated-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
   ```

1. Verifikasi bahwa pengguna terdaftar sebagai anggota `cluster-admins` grup.

   ```
   rosa list users --cluster=<CLUSTER_NAME>
   ```

## Akses klaster melalui Red Hat Hybrid Cloud Console
<a name="console-access-classic-cli"></a>

Setelah membuat pengguna klaster administrator atau menambahkan pengguna ke penyedia identitas yang dikonfigurasi, Anda dapat masuk klaster melalui Red Hat Hybrid Cloud Console.

1. Dapatkan URL konsol untuk Anda klaster menggunakan perintah berikut. Ganti `<CLUSTER_NAME>` dengan nama Anda klaster.

   ```
   rosa describe cluster -c <CLUSTER_NAME> | grep Console
   ```

1. Arahkan ke URL konsol di output dan masuk.
   + Jika Anda membuat `cluster-admin` pengguna, masuk menggunakan kredensi yang disediakan.
   + Jika Anda mengonfigurasi penyedia identitas untuk Anda klaster, pilih nama penyedia identitas di dialog **Masuk dengan...** dan lengkapi permintaan otorisasi apa pun yang disajikan oleh penyedia Anda.

## Menyebarkan aplikasi dari Katalog Pengembang
<a name="deploy-app-classic-cli"></a>

Dari Red Hat Hybrid Cloud Console, Anda dapat menerapkan aplikasi pengujian Katalog Pengembang dan mengeksposnya dengan rute.

1. Arahkan ke [Red Hat Hybrid Cloud Console](https://console.redhat.com/openshift) dan pilih cluster tempat Anda ingin menerapkan aplikasi.

1. Pada halaman cluster, pilih **Open console**.

1. Dalam perspektif **Administrator**, pilih **Home** > **Projects** > **Create Project**.

1. Masukkan nama untuk proyek Anda dan secara opsional tambahkan **Nama Tampilan** dan **Deskripsi**.

1. Pilih **Buat** untuk membuat proyek.

1. Beralih ke perspektif **Pengembang** dan pilih **\$1Tambah**. Pastikan bahwa proyek yang dipilih adalah yang baru saja dibuat.

1. Dalam dialog **Katalog Pengembang**, pilih **Semua layanan**.

1. Di halaman **Katalog Pengembang**, pilih **Bahasa** > **JavaScript**dari menu.

1. 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**.

1. Di bagian **Git**, pilih **Coba Sampel**.

1. Di bidang **Nama**, tambahkan nama unik.

1. Pilih **Buat**.
**catatan**  
Aplikasi baru membutuhkan waktu beberapa menit untuk digunakan.

1. Saat penerapan selesai, pilih URL rute untuk aplikasi.

   Tab baru di browser terbuka dengan pesan yang mirip dengan berikut ini.

   ```
   Welcome to your Node.js application on OpenShift
   ```

1. (Opsional) Hapus aplikasi dan bersihkan sumber daya:

   1. Dalam perspektif **Administrator**, pilih **Home** > **Projects**.

   1. Buka menu tindakan untuk proyek Anda dan pilih **Hapus Proyek**.

## Mencabut `cluster-admin` izin dari pengguna
<a name="revoke-cluster-admin-classic-cli"></a>

1. Cabut `cluster-admin` izin menggunakan perintah berikut. Ganti `<IDP_USER_NAME>` dan `<CLUSTER_NAME>` dengan pengguna dan klaster nama Anda.

   ```
   rosa revoke user cluster-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
   ```

1. Verifikasi bahwa pengguna tidak terdaftar sebagai anggota `cluster-admins` grup.

   ```
   rosa list users --cluster=<CLUSTER_NAME>
   ```

## Mencabut `dedicated-admin` izin dari pengguna
<a name="revoke-dedicated-admin-classic-cli"></a>

1. Cabut `dedicated-admin` izin dengan menggunakan perintah berikut. Ganti `<IDP_USER_NAME>` dan `<CLUSTER_NAME>` dengan pengguna dan klaster nama Anda.

   ```
   rosa revoke user dedicated-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME>
   ```

1. Verifikasi bahwa pengguna tidak terdaftar sebagai anggota `dedicated-admins` grup.

   ```
   rosa list users --cluster=<CLUSTER_NAME>
   ```

## Mencabut akses pengguna ke klaster
<a name="revoke-user-classic-cli"></a>

Anda dapat mencabut klaster akses untuk pengguna penyedia identitas dengan menghapusnya dari penyedia identitas yang dikonfigurasi.

Anda dapat mengonfigurasi berbagai jenis penyedia identitas untuk Anda klaster. Prosedur berikut mencabut klaster akses untuk anggota GitHub organisasi.

1. Arahkan ke [github.com](https://github.com/) dan masuk ke akun Anda. GitHub 

1. Hapus pengguna dari GitHub organisasi Anda. Untuk informasi selengkapnya, lihat [Menghapus anggota dari organisasi Anda](https://docs.github.com/en/organizations/managing-membership-in-your-organization/removing-a-member-from-your-organization) di GitHub dokumentasi.

## Hapus klaster dan AWS STS sumber daya
<a name="delete-cluster-classic-cli"></a>

Anda dapat menggunakan ROSA CLI untuk menghapus klaster yang menggunakan AWS Security Token Service ()AWS STS. Anda juga dapat menggunakan ROSA CLI untuk menghapus IAM peran dan penyedia OIDC yang dibuat oleh. ROSA Untuk menghapus IAM kebijakan yang dibuat oleh ROSA, Anda dapat menggunakan IAM konsol.

**penting**  
 IAM peran dan kebijakan yang dibuat oleh ROSA mungkin digunakan oleh ROSA cluster lain di akun yang sama.

1. 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 penghapusan sepenuhnya sebelum menghapus IAM peran, kebijakan, dan penyedia OIDC. klaster Peran IAM akun diperlukan untuk menghapus sumber daya yang dibuat oleh penginstal. Peran IAM operator diperlukan untuk membersihkan sumber daya yang dibuat oleh OpenShift operator. Operator menggunakan penyedia OIDC untuk mengautentikasi.

1. Hapus penyedia OIDC yang digunakan klaster operator untuk mengautentikasi dengan menjalankan perintah berikut.

   ```
   rosa delete oidc-provider -c <CLUSTER_ID> --mode auto
   ```

1. Hapus peran operator khusus cluster. IAM 

   ```
   rosa delete operator-roles -c <CLUSTER_ID> --mode auto
   ```

1. Hapus peran IAM akun menggunakan perintah berikut. Ganti `<PREFIX>` dengan awalan peran IAM akun yang akan dihapus. Jika Anda menetapkan awalan kustom saat membuat peran IAM akun, tentukan awalan default`ManagedOpenShift`.

   ```
   rosa delete account-roles --prefix <PREFIX> --mode auto
   ```

1. Hapus IAM kebijakan yang dibuat oleh ROSA.

   1. Masuk ke [IAM konsol](https://console.aws.amazon.com/iamv2/home#/home).

   1. Di menu sebelah kiri di bawah **Manajemen akses**, pilih **Kebijakan**.

   1. Pilih kebijakan yang ingin Anda hapus dan pilih **Tindakan** > **Hapus**.

   1. Masukkan nama kebijakan dan pilih **Hapus**.

   1. Ulangi langkah ini untuk menghapus setiap kebijakan IAM untuk. klaster