Antarmuka web cluster

Hindari Kerentanan Keamanan.

Port yang terbuka dan aturan firewall yang tidak dikonfigurasi dengan benar di jaringan publik dapat memungkinkan pengguna yang tidak sah untuk mengeksekusi kode arbitrer.^*

Tinjau Menentukan rentang IP sumber untuk aturan firewall subnet

Buat tunnel SSH untuk membuat koneksi yang aman ke instance master cluster Anda.

Apache Hadoop YARN menyediakan REST API yang memiliki port yang sama dengan antarmuka web YARN (port default 8088). Secara default, pengguna yang dapat menjangkau antarmuka web YARN dapat membuat aplikasi, mengirim tugas, dan mungkin dapat melakukan operasi Cloud Storage.Lihat REST API Resource Manager YARN yang Diizinkan untuk mengetahui informasi tentang cara menetapkan metode REST API Resource Manager YARN yang diizinkan.

Gunakan Gateway Komponen untuk terhubung ke antarmuka web komponen inti dan opsional. Cluster yang dibuat dengan image Managed Service untuk Apache Spark versi 1.3.29 dan yang lebih baru dapat menginstal dan mengaktifkan akses ke antarmuka web komponen, termasuk UI YARN, HDFS, Jupyter, dan Zeppelin, tanpa mengandalkan tunnel SSH atau mengubah aturan firewall untuk mengizinkan traffic masuk. Lihat Gateway Komponen Managed Service untuk Apache Spark untuk mengetahui informasi selengkapnya.

Lihat SSH ke cluster Managed Service untuk Apache Spark untuk membuka sesi SSH di node master cluster Managed Service untuk Apache Spark.

Antarmuka yang tersedia

Antarmuka berikut tersedia di node master cluster Managed Service untuk Apache Spark (ganti master-host-name dengan nama node master Anda).

master-host-name cluster adalah nama cluster Managed Service untuk Apache Spark Anda yang diikuti dengan akhiran -m—misalnya, jika cluster Anda bernama "my-cluster", master-host-name-nya adalah "my-cluster-m".

UI Web	Port	URL
YARN ResourceManager	8088^1	http://master-host-name:8088
HDFS NameNode	9870^2,3	http://master-host-name:9870

¹ Pada cluster yang mengaktifkan Kerberos, port UI web ResourceManager YARN adalah 8090, dan berjalan di HTTPS.

² Pada cluster yang mengaktifkan Kerberos, port UI web Namenode HDFS adalah 9871, dan berjalan di HTTPS.

³ Dalam rilis Managed Service untuk Apache Spark sebelumnya (pra-1.2), port UI web Namenode HDFS adalah 50070.

YARN ResourceManager memiliki link untuk semua antarmuka web Aplikasi MapReduce dan Spark yang sedang berjalan dan telah selesai di kolom "Tracking UI".

REST API ResourceManager YARN yang diizinkan

Saat Anda membuat cluster, Managed Service untuk Apache Spark menetapkan properti yarn-site.xml yarn.resourcemanager.webapp.methods-allowed ke "GET,HEAD". yang membatasi metode HTTP yang dapat dipanggil di UI web YARN Resource Manager dan REST API ke metode GET dan HEAD. Setelan default ini juga menonaktifkan pengiriman dan modifikasi tugas melalui YARN REST API.

Anda dapat mengganti nilai default untuk mengaktifkan metode HTTP tertentu pada port 8088 dengan menetapkan properti ini ke satu atau beberapa nama metode HTTP yang dipisahkan koma. Nilai ALL akan mengizinkan semua metode HTTP di port.

Contoh:

gcloud dataproc clusters create cluster-name \
    --properties=^#^yarn:yarn.resourcemanager.webapp.methods-allowed=GET,POST,DELETE \
    --region=region \

Rekomendasi: Jika Anda menetapkan properti ini untuk mengizinkan metode HTTP non-default, pastikan untuk mengonfigurasi aturan firewall dan setelan keamanan lainnya guna membatasi akses ke port 8088.

Terhubung ke antarmuka web

Anda dapat terhubung ke antarmuka web yang berjalan di cluster Managed Service untuk Apache Spark menggunakan Gateway Komponen Managed Service untuk Apache Spark, Cloud Shell project Anda, atau alat command line gcloud Google Cloud CLI:

• Component Gateway: Terhubung dengan sekali klik ke antarmuka UI Web Hadoop, Spark, dan komponen lainnya dari konsol Google Cloud . Anda mengaktifkan Gateway Komponen saat membuat cluster.

• Cloud Shell: Cloud Shell di konsol Google Cloud memiliki perintah dan utilitas gcloud CLI yang telah diinstal sebelumnya, dan menyediakan fitur Web Preview yang memungkinkan Anda terhubung dengan cepat melalui tunnel SSH ke port antarmuka web di cluster. Namun, koneksi ke cluster dari Cloud Shell menggunakan penerusan port lokal, yang membuka koneksi hanya ke satu port di antarmuka web cluster—beberapa perintah diperlukan untuk terhubung ke beberapa port. Selain itu, sesi Cloud Shell otomatis keluar setelah tidak aktif selama periode tertentu (30 menit).

• Google Cloud CLI: Perintah gcloud compute ssh dengan penerusan port dinamis memungkinkan Anda membuat tunnel SSH dan menjalankan server proxy SOCKS di atas tunnel. Setelah mengeluarkan perintah ini, Anda harus mengonfigurasi browser lokal untuk menggunakan proxy SOCKS. Metode koneksi ini memungkinkan Anda terhubung ke beberapa port di antarmuka web cluster. Lihat Dapatkah saya menggunakan penerusan port lokal, bukan proxy SOCKS? untuk mengetahui informasi selengkapnya.

Menetapkan variabel perintah yang umum digunakan

Untuk mempermudah penyalinan dan menjalankan contoh command line di komputer lokal Anda atau di Cloud Shell, tetapkan variabel perintah gcloud dataproc. Variabel tambahan mungkin perlu ditetapkan untuk beberapa contoh perintah yang ditampilkan di halaman ini.

Linux/mac/Shell

export PROJECT=project;export HOSTNAME=hostname;export ZONE=zone

Windows

set PROJECT=project && set HOSTNAME=hostname && set ZONE=zone

• Tetapkan PROJECT ke Google Cloud project ID Anda
• Tetapkan HOSTNAME ke nama node master di cluster Managed Service untuk Apache Spark Anda (nama master diakhiri dengan akhiran -m)
• Tetapkan ZONE ke zona VM di cluster Managed Service untuk Apache Spark Anda (misalnya, "us-central1-b")

Membuat tunnel SSH

Perintah gcloud

Jalankan perintah gcloud berikut di komputer lokal Anda untuk menyiapkan tunnel SSH dari port terbuka di komputer lokal Anda ke instance master cluster Anda, dan jalankan server proxy SOCKS lokal yang memproses port tersebut.

Sebelum menjalankan perintah, di komputer lokal Anda:

1. Menetapkan variabel perintah yang umum digunakan
2. Tetapkan variabel PORT ke port terbuka di komputer lokal Anda. Port 1080 adalah pilihan arbitrer, tetapi umum karena kemungkinan besar terbuka.

   PORT=number
   

Linux/macOS

gcloud compute ssh ${HOSTNAME} \
    --project=${PROJECT} --zone=${ZONE}  -- \
    -D ${PORT} -N

Windows

gcloud compute ssh %HOSTNAME% ^
    --project=%PROJECT% --zone=%ZONE%  -- ^
    -D %PORT% -N

Pemisah -- memungkinkan Anda menambahkan argumen SSH ke perintah gcloud compute ssh, sebagai berikut:

• -Dmenentukan penerusan port tingkat aplikasi dinamis.
• -N menginstruksikan gcloud untuk tidak membuka shell jarak jauh.

Perintah gcloud ini membuat tunnel SSH yang beroperasi secara independen dari sesi shell SSH lainnya, mencegah error terkait tunnel muncul di output shell, dan membantu mencegah penutupan tunnel yang tidak disengaja.

Jika perintah ssh gagal dengan pesan error bind: Cannot assign requested address, kemungkinan penyebabnya adalah port yang diminta sedang digunakan. Coba jalankan perintah dengan nilai variabel PORT yang berbeda.

Perintah di atas berjalan di latar depan, dan harus terus berjalan agar tunnel tetap aktif. Perintah akan otomatis keluar jika dan saat Anda menghapus cluster.

Pilih untuk menjalankan perintah di latar belakang. Anda dapat menjalankan perintah sebagai proses latar belakang dengan menambahkan flag `-n` (-- -D ${PORT} -N -n), yang mengalihkan stdin dari /dev/null. Perhatikan bahwa flag -n mungkin tidak didukung di semua sistem operasi.

Cloud Shell

1. Buka Google Cloud Cloud Shell.

   

   Waktu Tunggu Sesi Cloud Shell: Sesi Cloud Shell otomatis keluar setelah tidak ada aktivitas selama jangka waktu tertentu (30 menit).

2. Jalankan perintah gcloud di bawah ini di Cloud Shell untuk menyiapkan tunnel SSH dari port pratinjau Cloud Shell ke port antarmuka web pada node master di cluster Anda. Sebelum menjalankan perintah, di Cloud Shell :

   1. Menetapkan variabel perintah yang umum digunakan
   2. Tetapkan variabel PORT1 ke port Cloud Shell dalam rentang port 8080 - 8084, dan tetapkan variabel PORT2 ke port antarmuka web pada node master di cluster Managed Service untuk Apache Spark Anda.

      PORT1=number
      PORT2=number
      

   gcloud compute ssh ${HOSTNAME} \
       --project=${PROJECT} --zone=${ZONE}  -- \
       -4 -N -L ${PORT1}:${HOSTNAME}:${PORT2}
   

   Pemisah -- memungkinkan Anda menambahkan argumen SSH ke perintah gcloud compute ssh, sebagai berikut:

   • -4 menginstruksikan ssh untuk hanya menggunakan IPv4.
   • -N menginstruksikan gcloud untuk tidak membuka shell jarak jauh.
   • -L ${PORT1}:${HOSTNAME}:${PORT2} menentukan penerusan port lokal dari PORT1 Cloud Shell yang ditentukan ke HOSTNAME:PORT2 cluster.

   Perintah gcloud ini membuat tunnel SSH yang beroperasi secara independen dari sesi shell SSH lainnya, mencegah error terkait tunnel muncul di output shell, dan membantu mencegah penutupan tunnel yang tidak disengaja.

Mengonfigurasi browser

Perintah gcloud

Tunnel SSH Anda mendukung proxy traffic menggunakan protokol SOCKS. Untuk mengonfigurasi browser agar menggunakan proxy, mulai sesi browser baru dengan parameter server proxy. Berikut adalah contoh yang menggunakan browser Google Chrome. HOSTNAME adalah nama node master cluster (lihat Menetapkan variabel perintah yang umum digunakan).

Linux

/usr/bin/google-chrome \
    --proxy-server="socks5://localhost:${PORT}" \
    --user-data-dir=/tmp/${HOSTNAME}

macOS

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
    --proxy-server="socks5://localhost:${PORT}" \
    --user-data-dir=/tmp/${HOSTNAME}

Windows

"%ProgramFiles(x86)%\Google\Chrome\Application\chrome.exe" ^
    --proxy-server="socks5://localhost:%PORT%" ^
    --user-data-dir="%Temp%\%HOSTNAME%"

Pengguna Windows 32 bit: Ubah %ProgramFiles(x86)% menjadi %ProgramFiles% dalam perintah di atas.

Perintah ini menggunakan flag browser Chrome berikut:

• -proxy-server="socks5://localhost:1080" memberi tahu Chrome untuk mengirim semua permintaan URL http:// dan https:// melalui server proxy SOCKS localhost:${PORT}, menggunakan protokol SOCKS versi 5. ${PORT} adalah variabel port yang Anda tetapkan di Membuat tunnel SSH. Nama host untuk URL di-resolve oleh server proxy, bukan secara lokal oleh Chrome.
• --user-data-dir=/tmp/${HOSTNAME} memaksa Chrome untuk membuka jendela baru yang tidak terkait dengan sesi Chrome yang ada. Tanpa flag ini, Chrome dapat membuka jendela baru yang terpasang ke sesi Chrome yang ada, dengan mengabaikan setelan --proxy-server Anda. Nilai yang ditetapkan untuk --user-data-dir dapat berupa jalur yang tidak ada.

Ekstensi proxy: Ekstensi pengelolaan proxy yang menyederhanakan pengelolaan dan penggunaan proxy di browser Anda tersedia untuk Chrome, Firefox, dan browser web lainnya.

Cloud Shell

Anda tidak perlu mengonfigurasi browser lokal saat menggunakan Cloud Shell. Setelah membuat tunnel SSH, gunakan pratinjau web Cloud Shell untuk terhubung ke antarmuka cluster.

Menghubungkan ke antarmuka cluster

Perintah gcloud

Setelah browser lokal dikonfigurasi untuk menggunakan proxy, Anda dapat membuka URL antarmuka web di cluster Managed Service untuk Apache Spark (lihat Antarmuka yang tersedia). URL browser memiliki format dan konten berikut: http://cluster-name-m:port (port antarmuka cluster)

Cloud Shell

Klik tombol Web Preview Cloud Shell , lalu pilih salah satu:

• "Preview on port 8080", atau
• "Ubah port" dan masukkan nomor port dalam dialog

sesuai dengan nomor PORT1 Cloud Shell (port 8080 - 8084) yang Anda teruskan ke perintah gcloud compute ssh di Membuat tunnel SSH.

Jendela browser akan terbuka dan terhubung ke port antarmuka web di node master cluster.

Pesan Browser Chrome: Saat menggunakan browser Chrome, Anda mungkin melihat pesan dengan jenis berikut di jendela terminal atau Cloud Shell yang Anda gunakan untuk membuat tunnel SSH.

channel 15: open failed: administratively prohibited: open failed
channel 16: open failed: administratively prohibited: open failed
channel 17: open failed: administratively prohibited: open failed

Ini bukan pesan error fatal. Browser Chrome akan menampilkan pesan ini jika tidak dapat memuat halaman, dan Anda mungkin melihat pesan ini meskipun Anda berhasil terhubung ke antarmuka aplikasi di cluster Anda.

FAQ dan tips proses debug

Bagaimana jika saya tidak melihat UI di browser saya?

Jika Anda tidak melihat UI di browser, dua alasan paling umum adalah:

1. Anda mengalami masalah konektivitas jaringan, mungkin karena firewall. Jalankan perintah berikut (setelah menetapkan variabel lokal) untuk melihat apakah Anda dapat melakukan SSH ke instance master. Jika tidak bisa, berarti ada masalah konektivitas.

   Linux/macOS

   gcloud compute ssh ${HOSTNAME}-m \
       --project=${PROJECT}
   

   Windows

   gcloud compute ssh %HOSTNAME%-m ^
       --project=%PROJECT%
   

2. Proxy lain mengganggu proxy SOCKS. Untuk memeriksa proxy, jalankan perintah curl berikut (tersedia di Linux dan macOS):

   Linux/macOS

   curl -Is --socks5-hostname localhost:1080 http://cluster-name-m:8088
   

   Windows

   curl.exe -Is --socks5-hostname localhost:1080 http://cluster-name-m:8088
   

   Jika Anda melihat respons HTTP, berarti proxy berfungsi, sehingga ada kemungkinan proxy SOCKS terganggu oleh proxy atau ekstensi browser lain.

Dapatkah saya menggunakan penerusan port lokal, bukan proxy SOCKS?

Alih-alih proxy SOCKS, Anda dapat mengakses UI aplikasi web yang berjalan di instance master dengan penerusan port lokal SSH, yang meneruskan port master ke port lokal. Misalnya, perintah berikut memungkinkan Anda mengakses localhost:1080 untuk menjangkau cluster-name-m:8088 tanpa SOCKS (lihat Menetapkan variabel perintah yang umum digunakan):

Linux/macOS

gcloud compute ssh ${HOSTNAME}-m \
    --project=${PROJECT} -- \
    -L 1080:${HOSTNAME}-m:8088 -N -n

Windows

gcloud compute ssh %HOSTNAME%-m ^
    --project=%PROJECT% -- ^
    -L 1080:%HOSTNAME%-m:8088 -N -n

Dengan proxy SOCKS, Anda mengakses antarmuka UI jarak jauh yang berjalan di instance master dengan http://cluster-name-m:port, tetapi dengan penerusan port lokal, Anda mengakses UI aplikasi web instance master di http://localhost:port.

Menggunakan proxy SOCKS mungkin lebih disarankan daripada menggunakan penerusan port lokal karena proxy:

• memungkinkan Anda mengakses semua port aplikasi web tanpa harus menyiapkan tunnel penerusan port untuk setiap port UI
• memungkinkan UI web Spark dan Hadoop me-resolve host DNS dengan benar