Mengelola kumpulan agen

Pembentukan agen adalah kumpulan agen yang menggunakan konfigurasi yang sama, dengan akses dan visibilitas yang seragam ke sumber dan tujuan Anda. Kumpulan agen juga memberikan kontrol atas batas bandwidth transfer.

Semua agen harus tergabung dalam kumpulan agen.

Panduan ini menjelaskan cara menggunakan kumpulan agen.

Sebelum memulai

Anda harus memiliki izin yang benar di project untuk menggunakan kumpulan agen. Lihat Kontrol akses dengan IAM untuk mengetahui detailnya.

Anda dapat melihat izin saat ini.

Untuk menggunakan perintah gcloud, instal alat command line gcloud.

Membuat kumpulan agen

Jangan sertakan informasi sensitif seperti informasi identitas pribadi (PII) atau data keamanan dalam nama kumpulan agen atau awalan ID agen Anda. Nama resource dapat di-propagasi ke nama resource Google Cloud lainnya dan dapat diekspos ke sistem internal Google di luar project Anda.

Untuk membuat kumpulan agen:

Konsol Google Cloud

  1. Di konsol Google Cloud, buka halaman Agent pools.

    Buka Kumpulan agen

    Halaman Kumpulan agen akan ditampilkan, yang mencantumkan kumpulan agen yang ada.

  2. Klik Buat kumpulan lain.

  3. Beri nama kumpulan Anda, dan jika perlu, deskripsikan.

  4. Anda dapat memilih untuk menetapkan batas bandwidth yang akan berlaku untuk seluruh kumpulan. Bandwidth yang ditentukan dalam MB/s akan dibagi di antara semua agen dalam kumpulan. Lihat Mengelola bandwidth jaringan untuk mengetahui informasi selengkapnya.

  5. Klik Create.

REST API

Gunakan projects.agentPools.create:

POST https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools?agent_pool_id=AGENT_POOL_ID

Dengan keterangan:

  • PROJECT_ID: Project ID tempat Anda membuat kumpulan agen.
  • AGENT_POOL_ID: ID kumpulan agen yang Anda buat.

Jika kumpulan agen macet dalam status Creating selama lebih dari 30 menit, sebaiknya hapus kumpulan agen dan buat lagi.

Menghapus izin Storage Transfer Service yang diperlukan dari project saat kumpulan agen dalam status Creating akan menyebabkan perilaku layanan yang salah.

gcloud CLI

Untuk membuat kumpulan agen dengan alat command line gcloud, jalankan gcloud transfer agent-pools create.

gcloud transfer agent-pools create AGENT_POOL

Dengan opsi berikut yang tersedia:

  • AGENT_POOL adalah ID unik dan permanen untuk kumpulan ini.

  • --no-async memblokir tugas lain di terminal Anda hingga kumpulan telah dibuat. Jika tidak disertakan, pembuatan kumpulan akan berjalan secara asinkron.

  • --bandwidth-limit menentukan jumlah bandwidth dalam MB/dtk yang akan tersedia untuk agen kumpulan ini. Batas bandwidth berlaku untuk semua agen dalam kumpulan dan dapat membantu mencegah beban kerja transfer kumpulan mengganggu operasi lain yang menggunakan bandwidth Anda. Misalnya, masukkan '50' untuk menetapkan batas bandwidth 50 MB/dtk. Dengan membiarkan tanda ini tidak ditentukan, agen kumpulan ini akan menggunakan semua bandwidth yang tersedia untuk mereka.

  • --display-name adalah nama yang dapat diubah untuk membantu Anda mengidentifikasi kumpulan ini. Anda dapat menyertakan detail yang mungkin tidak sesuai dengan nama resource lengkap unik kumpulan.

Menetapkan agen ke kumpulan

Kumpulan agen baru kosong dan harus memiliki agen yang ditetapkan. Agen hanya dapat ditetapkan ke kumpulan agen pada saat pembuatan agen.

Jika kumpulan agen tidak ditentukan, agen akan ditetapkan ke kumpulan transfer_service_default.

Untuk membuat agen dan menetapkannya ke kumpulan:

Konsol Google Cloud

  1. Dari halaman Agent pools, pilih kumpulan untuk menetapkan agen.

  2. Klik Instal agen. Panduan penginstalan Agen akan muncul.

  3. Ikuti petunjuk untuk membuat agen di kumpulan agen ini.

gcloud CLI

Untuk menggunakan alat command line gcloud guna membuat agen dan menetapkannya ke kumpulan, jalankan gcloud transfer agents install. Agen harus diinstal di komputer dengan akses root ke sistem file.

gcloud transfer agents install --pool=AGENT_POOL

Untuk menginstal agen yang akan digunakan dengan sumber yang kompatibel dengan S3, berikan kredensial akses sebagai variabel lingkungan sebagai nilai AWS_ACCESS_KEY_ID dan AWS_SECRET_ACCESS_KEY, atau disimpan sebagai kredensial default dalam file konfigurasi sistem Anda.

export AWS_ACCESS_KEY_ID=ID
export AWS_SECRET_ACCESS_KEY=SECRET
gcloud transfer agents install --pool=AGENT_POOL

Lihat Mengelola agen transfer untuk mengetahui detail selengkapnya.

Untuk opsi tambahan, lihat Opsi agen lanjutan.

Untuk mengelola agen, lihat Mengelola agen transfer.

Menetapkan kumpulan agen ke tugas

Setelah dibuat, kumpulan agen dapat ditetapkan ke tugas selama pembuatan atau pembaruan tugas.

Memperbarui kumpulan agen

Anda dapat memperbarui nama tampilan dan batas bandwidth kumpulan agen.

Untuk memperbarui kumpulan agen:

Konsol Google Cloud

Di konsol Google Cloud, buka halaman Agent pools.

Buka Kumpulan agen

Anda dapat mengedit item berikut:

  • Nama tampilan kumpulan agen: Klik Edit di samping nama Kumpulan agen saat ini.

  • Batas bandwidth kumpulan agen: Klik Tetapkan batas bandwidth, lalu masukkan batas bandwidth baru di dialog Tetapkan batas bandwidth. Klik Tetapkan Batas untuk menerapkan batas bandwidth baru. Bandwidth dibagikan ke semua agen dalam kumpulan.

REST API

Untuk memperbarui kumpulan agen, gunakan projects.agentPools.patch dengan mask kolom kolom yang akan diperbarui. Kolom kumpulan agen berikut dapat diperbarui:

Misalnya, untuk memperbarui displayName menjadi my-transfer, Anda akan memberikan mask kolom "displayName,my-transfer".

Berikut adalah contoh permintaan patch untuk memperbarui nama tampilan:

PATCH https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL:"displayName,NEW_DISPLAY_NAME"

Dengan keterangan:

  • PROJECT_ID: Project ID tempat Anda memperbarui kumpulan agen.
  • AGENT_POOL: Nama kumpulan agen yang Anda perbarui.
  • NEW_DISPLAY_NAME: Nama tampilan baru untuk kumpulan agen ini.

Berikut adalah contoh permintaan patch untuk memperbarui batas bandwidth:

PATCH https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL:"bandwidthLimit,NEW_LIMIT"

Dengan keterangan:

  • PROJECT_ID: Project ID tempat Anda memperbarui kumpulan agen.
  • AGENT_POOL: ID kumpulan agen yang Anda perbarui.
  • NEW_LIMIT: Batas bandwidth baru untuk kumpulan agen ini.

gcloud CLI

Untuk menggunakan alat command line gcloud guna mengupdate kumpulan agen, jalankan gcloud transfer agent-pools update.

gcloud transfer agent-pools update AGENT_POOL \
  [--bandwidth-limit=NEW_BANDWIDTH_LIMIT] [--clear-bandwidth-limit] \
  [--clear-display-name] [--display-name=NEW_DISPLAY_NAME]

Argumen berikut diperlukan:

  • AGENT_POOL adalah ID unik dan permanen untuk kumpulan ini. AGENT_POOL mengidentifikasi kumpulan agen yang akan diperbarui, dan tidak dapat diperbarui sendiri.

Flag berikut dapat ditentukan dengan perintah ini:

  • --bandwidth-limit dapat diperbarui, atau dihapus dengan menentukan --clear-bandwidth-limit. Lihat Membuat kumpulan agen untuk mengetahui detail selengkapnya tentang batas bandwidth.

  • --display-name dapat diperbarui, atau dihapus dengan tanda --clear-display-name.

Menghapus kumpulan agen

Anda dapat menghapus kumpulan agen yang tidak memiliki agen aktif dan tidak ada tugas aktif yang berjalan.

Untuk menghapus kumpulan agen:

Konsol Google Cloud

  1. Di konsol Google Cloud, buka halaman Agent pools.

    Buka Kumpulan agen

  2. Klik Delete. Baca pop-up, lalu klik Hapus untuk mengonfirmasi.

    Jika tombol hapus tidak aktif, Anda harus menghentikan semua agen dan tugas yang terkait dengan kumpulan ini.

REST API

Gunakan projects.agentPools.delete:

DELETE https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL

Dengan keterangan:

  • PROJECT_ID: Project ID tempat Anda menghapus kumpulan agen.
  • AGENT_POOL: Nama kumpulan agen.

gcloud CLI

Untuk menggunakan alat command line gcloud guna menghapus kumpulan agen, jalankan gcloud transfer agent-pools delete.

gcloud transfer agent-pools delete AGENT_POOL

Argumen berikut diperlukan:

  • AGENT_POOL adalah ID unik dan permanen untuk kumpulan ini.

Sebelum Anda dapat menghapus kumpulan, semua agen dalam kumpulan harus dihentikan, tugas kumpulan harus dinonaktifkan, dan tidak boleh ada operasi transfer yang sedang berlangsung untuk kumpulan ini.

Untuk melihat semua tugas yang terkait dengan kumpulan tugas, pilih kumpulan tugas Anda di konsol Google Cloud, lalu klik tab Transfer tugas.

Mendapatkan kumpulan agen

Untuk mendapatkan kumpulan agen:

Konsol Google Cloud

Di konsol Google Cloud, buka halaman Agent pools.

Buka Kumpulan agen

Halaman ini menampilkan daftar semua kumpulan agen yang terkait dengan project Anda, dan informasi berikut untuk setiap kumpulan agen:

  • Nama kumpulan agen
  • Status koneksi
  • Jumlah agen yang terhubung
  • Batas bandwidth, jika ditetapkan
  • Jumlah tugas transfer terkait
  • Nama tampilan kumpulan agen

Untuk melihat kumpulan agen tertentu, klik Nama kumpulan agen.

Tindakan berikut tersedia dari halaman informasi kumpulan agen:

  • Instal agen: menampilkan petunjuk untuk menginstal agen Transfer.
  • Hentikan agen: Pilih agen di tabel, lalu klik Stop Agent.
  • Mencantumkan tugas transfer: Klik Transfer Jobs untuk menampilkan tugas transfer yang terhubung ke agen di kumpulan ini.

REST API

Gunakan projects.agentPools.get:

GET https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools/AGENT_POOL

Dengan keterangan:

  • PROJECT_ID: Project ID tempat Anda mendapatkan kumpulan agen.
  • AGENT_POOL: Kumpulan agen yang akan diambil.

gcloud CLI

Untuk menggunakan alat command line gcloud guna mengambil kumpulan agen, jalankan gcloud transfer agent-pools describe.

gcloud transfer agent-pools describe AGENT_POOL

Argumen berikut diperlukan:

  • AGENT_POOL adalah ID unik dan permanen untuk kumpulan ini.

Mencantumkan kumpulan agen

Untuk mencantumkan kumpulan agen:

Konsol Google Cloud

Di konsol Google Cloud, buka halaman Agent pools.

Buka Kumpulan agen

Semua kumpulan agen akan ditampilkan.

REST API

Gunakan projects.agentPools.list:

GET https://storagetransfer.googleapis.com/v1/projects/PROJECT_ID/agentPools

Dengan keterangan:

  • PROJECT_ID: Project ID yang akan mencantumkan kumpulan agen.

gcloud CLI

Untuk menggunakan alat command line gcloud guna mencantumkan kumpulan agen, jalankan gcloud transfer agent-pools list.

gcloud transfer agent-pools list \
  [--limit=LIMIT] \
  [--names=[NAMES,...]] \
  [--page-size=PAGE_SIZE]

Flag berikut dapat ditentukan dengan perintah ini:

  • --limit menentukan jumlah maksimum kumpulan agen yang akan ditampilkan.

  • --names menentukan nama kumpulan agen yang akan dicantumkan. Pisahkan beberapa nama dengan koma; misalnya, --names=foo,bar. Jika tidak ditentukan, semua kumpulan agen dalam project saat ini akan dicantumkan.

  • --page-size menentukan perilaku pengelompokan untuk perintah ini. Secara default, perintah list mengelompokkan respons ke dalam 256 item, yang otomatis mengambil batch berikutnya hingga semua item tercantum atau limit tercapai.

Perintah ini menampilkan daftar kumpulan agen yang cocok dan detail konfigurasinya. Contoh berikut menunjukkan contoh respons.

name: projects/my-project-123/agentPools/my-first-pool
state: CREATED
---
bandwidthLimit:
  limitMbps: '120'
displayName: Source A to destination Z.
name: projects/my-project-123/agentPools/a2z-pool
state: CREATED