

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

# Opsi instalasi
<a name="installation-options"></a>

Ada dua cara utama untuk menginstal Red Hat OpenShift AWS:
+ Installer-provisioned infrastructure (IPI) — Pengguna menyediakan informasi dasar (seperti jumlah mesin control plane) dan dapat memilih nilai default untuk sebagian besar pertanyaan. Red Hat OpenShift Service on AWS command line utility (`rosa`CLI) dapat ditempatkan dalam struktur IPI, seperti yang dibahas di bagian selanjutnya.
+ Infrastruktur yang disediakan pengguna (UPI) - Semua komponen infrastruktur, seperti Domain Name Server (DNS), Amazon virtual private cloud (VPCs), mesin bootstrap, dan pesawat kontrol dibuat secara manual, dan Red Hat diinstal di atas infrastruktur OpenShift itu.

Kedua setup menggunakan program instalasi (`install-config.yaml`) yang sama, yang menginstal komponen berdasarkan target dan dependensi. Setiap target memiliki dependensi sendiri, sehingga program dapat mendukung beberapa target secara paralel dan memastikan bahwa target dapat berhasil menjalankan cluster. Diagram berikut menunjukkan beberapa target dan dependensi.

![Target dan dependensi untuk Red Hat OpenShift AWS](http://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/red-hat-openshift-on-aws-implementation/images/targets-dependencies.png)


## Keuntungan dan kerugian dari setiap pendekatan
<a name="adv-disadv"></a>


****  

| Infrastruktur yang disediakan penginstal (IPI) | Infrastruktur yang disediakan pengguna (UPI) | 
| --- | --- | 
| Mudah dipasang. | Kompleks; membutuhkan waktu untuk mengatur. | 
| Tidak menyediakan banyak opsi penyesuaian. | Anda dapat menyesuaikan topologi dan seluruh infrastruktur. | 
| Mendukung AWS dan opsi cloud publik lainnya. | Mendukung VMware dan sistem bare metal serta AWS dan opsi cloud lainnya. | 
| Menciptakan semua komponen infrastruktur, termasuk penyeimbang beban dan jaringan virtual. | Dapat digunakan ketika platform yang mendasarinya tidak memenuhi semua persyaratan. (Misalnya, sistem bare metal tidak menyediakan penyeimbang beban.) | 
| Sangat otomatis. | Mengharuskan Anda untuk membuat seluruh lapisan otomatisasi untuk menyediakan infrastruktur yang mendasarinya. Anda dapat menggunakan AWS CloudFormation template untuk tujuan ini. | 
| Pemeriksaan prasyarat mudah dilakukan. | Prasyarat harus divalidasi dengan hati-hati. | 

## Contoh IPI — menggunakan CLI `rosa`
<a name="ipi-example1"></a>

Red Hat OpenShift Service pada AWS mengimplementasikan jenis instalasi IPI, tetapi memberikan manfaat tambahan. Anda menggunakan `rosa` CLI untuk mengelola (memperbarui, menghapus, atau menyediakan) Red Hat OpenShift pada AWS cluster dan sumber daya. Untuk informasi selengkapnya, lihat [ OpenShift dokumentasi Red Hat](https://docs.openshift.com/rosa/rosa_getting_started/rosa-getting-started.html). 

Untuk menyediakan OpenShift kluster Red Hat AWS, Anda terlebih dahulu menginstal `rosa` CLI dan memastikan bahwa AWS Command Line Interface (AWS CLI) menunjuk ke akun Anda AWS . Anda kemudian dapat menggunakan `rosa` CLI untuk melakukan validasi dan menyediakan cluster dengan menggunakan perintah yang mirip dengan berikut ini.

```
rosa verify permissions [arguments]
rosa download oc

rosa verify quota [arguments]
rosa init --token=<token> 
rosa create cluster --cluster-name=<cluster_name>
```

Ketika cluster telah disediakan, Anda dapat memverifikasinya dengan menggunakan OpenShift perintah.

```
oc get nodes (list all nodes if connected to cluster)
oc get ns (list all namespaces)
```

Lihat informasi yang lebih lengkap dalam [dokumentasi OpenShift ](https://docs.openshift.com/rosa/cli_reference/openshift_cli/getting-started-cli.html). 

Manfaat menggunakan metode ini meliputi:
+ Mudah diatur dan menyediakan cluster dengan cepat AWS.
+ Menyediakan informasi pencatatan; mudah untuk memecahkan masalah jika terjadi kesalahan.
+ Dapat memvalidasi prasyarat melalui baris perintah.
+ Dapat digunakan untuk penghapusan dan operasi lainnya juga.

Beberapa kemungkinan kekhawatiran:
+ Opsi kustomisasi mungkin terbatas.
+ Membutuhkan `rosa` CLI, AWS CLI, dan pengaturan dasar lainnya.
+ Semua tantangan dengan IPI berlaku untuk menggunakan `rosa` CLI juga.

## Contoh IPI — menggunakan `openshift-install`
<a name="ipi-example2"></a>

`openshift-install`adalah utilitas baris perintah yang dapat Anda gunakan untuk membuat cluster dengan cepat. Perintah ini memberikan beberapa fleksibilitas melalui modifikasi pada `install-config.yaml` file. Bagian ini memberikan langkah-langkah tingkat tinggi untuk menggunakan utilitas. Untuk langkah-langkah instalasi rinci, lihat [OpenShift dokumentasi](https://docs.openshift.com/container-platform/4.6/installing/installing_aws/installing-aws-default.html).

1. Dapatkan installer dari [situs web Red Hat](https://console.redhat.com/openshift/install) (memerlukan akun Red Hat).

1. Untar paketnya. 

   ```
   tar xvf openshift-install-linux.tar.gz
   ```

1. Identifikasi direktori instalasi, dan jalankan `create cluster` perintah.

   ```
   ./openshift-install create cluster --dir <installation_directory> --log-level=info
   ```

1. Untuk menyesuaikan instalasi, buat `install-config.yaml` file.

   ```
   ./openshift-install create install-config --dir <installation_directory>
   ```

Berikut ini memberikan kutipan dari file sampel`install-config.yaml`. Untuk opsi konfigurasi, lihat [OpenShift dokumentasi](https://docs.openshift.com/container-platform/4.7/installing/installing_aws/installing-aws-customizations.html).

```
      apiVersion: v1
baseDomain: sample.com 
credentialsMode: Mint 
controlPlane:   
  hyperthreading: Enabled 
  name: master
  platform:
    aws:
      zones:
      - us-east-2a
      - us-east-2b
      rootVolume:
        iops: 4000
        size: 500
        type: io1 
      type: m5.xlarge
  replicas: 3
compute: 
- hyperthreading: Enabled 
  name: worker
  platform:
    aws:
      rootVolume:
        iops: 2000
        size: 500
        type: io1 
      type: c5.4xlarge
      zones:
      - us-east-2c
  replicas: 3
metadata:
  name: sample-cluster 
networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  machineNetwork:
  - cidr: 10.0.0.0/16
  networkType: OpenShiftSDN
  serviceNetwork:
  - 172.30.0.0/16
platform:
  aws:
    region: us-west-2 
    userTags:
      adminContact: jdoe
      costCenter: 7536
    amiID: ami-96c6f8f7 
    serviceEndpoints: 
      - name: ec2
        url: https://vpce-id.ec2.us-west-2.vpce.amazonaws.com
fips: false 
sshKey: ssh-ed25519 AAAA... 
pullSecret: '{"auths": ...}'
```

## Contoh UPI - menginstal pada infrastruktur yang disediakan pengguna AWS
<a name="upi-example"></a>

Anda dapat menyediakan OpenShift klaster Red Hat pada AWS infrastruktur yang sudah ada yang Anda sediakan secara terpisah. Untuk menyediakan infrastruktur, Anda dapat menggunakan CloudFormation template untuk membuat VPC, zona yang dihosting, catatan DNS, dan komponen lainnya. Untuk langkah-langkah rinci dan CloudFormation template, lihat [OpenShift dokumentasi](https://docs.redhat.com/en/documentation/openshift_container_platform/4.1/html/installing/installing-on-user-provisioned-aws).

Ketika klaster telah disediakan, Anda harus menyetujui semua permintaan penandatanganan sertifikat (CSRs) untuk memindahkan node pekerja ke status. `Ready`

```
oc get nodes

NAME      STATUS    ROLES   AGE  VERSION
master-0  Ready     master  63m  v1.13.4+b626c2fe1
master-1  Ready     master  63m  v1.13.4+b626c2fe1
master-2  Ready     master  64m  v1.13.4+b626c2fe1
worker-0  NotReady  worker  76s  v1.13.4+b626c2fe1
worker-1  NotReady  worker  70s  v1.13.4+b626c2fe1
```

Anda dapat menyetujui semua sertifikat dalam satu langkah dengan menggunakan perintah berikut.

```
    oc get csr -ojson | jq -r '.items[] | select(.status == {} ) | .metadata.name' | xargs oc adm certificate approve
```

Anda dapat memverifikasi bahwa semua operator berada di `Ready` panggung dengan menggunakan baris `oc` perintah atau dari konsol Red Hat.

Setelah verifikasi, Anda dapat menghapus sumber daya bootstrap. Anda dapat menentukan `stack-name` dari Konsol Manajemen AWS, dan dari nama yang Anda berikan saat Anda membuat tumpukan.

```
aws cloudformation delete-stack --stack-name <name> 
```

Selesai penyediaan cluster dengan menggunakan perintah berikut.

```
./openshift-install --dir=<installation_directory> wait-for install-complete 

INFO Waiting up to 30m0s for the cluster to initialize...
```

Pastikan untuk memeriksa log dan mengonfirmasi bahwa tidak ada kesalahan sebelum Anda mengirimkan klaster ke pemangku kepentingan Anda.