Kumpulan 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 termasuk dalam kumpulan agen.
Panduan ini menjelaskan cara menggunakan kumpulan agen.
Sebelum memulai
Anda harus memiliki izin yang benar pada project Anda untuk menggunakan kumpulan agen. Lihat Kontrol akses dengan IAM untuk mengetahui detailnya.
Anda dapat melihat izin Anda saat ini.
Untuk menggunakan perintah gcloud,
instal alat command line gcloud.
Membuat kumpulan agen
Untuk membuat kumpulan agen:
Konsol Google Cloud
Di konsol Google Cloud , buka halaman Agent pools.
Halaman Agent pools akan ditampilkan, yang mencantumkan kumpulan agen yang ada.
Klik Create another pool.
Beri nama pool Anda, dan deskripsikan jika perlu.
Anda dapat memilih untuk menetapkan batas bandwidth yang akan berlaku untuk pool secara keseluruhan. Bandwidth yang ditentukan dalam MB/dtk akan dibagi di antara semua agen dalam kumpulan. Lihat Mengelola bandwidth jaringan untuk mengetahui informasi selengkapnya.
Klik Create.
REST API
Gunakan projects.agentPools.create:
POST https://storagetransfer./v1/projects/PROJECT_ID/agentPools?agent_pool_id=AGENT_POOL_ID
Ganti kode berikut:
PROJECT_ID: Project ID tempat Anda membuat kumpulan agen.AGENT_POOL_ID: ID kumpulan agen yang Anda buat.
Jika agen pool terjebak dalam status Creating selama lebih dari 30 menit,
sebaiknya hapus agen pool dan buat lagi.
Mencabut izin Storage Transfer Service yang diperlukan dari project saat
pool agen berada 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:
AGENT_POOL adalah ID unik dan permanen untuk kumpulan ini.
--no-asyncmemblokir tugas lain di terminal Anda hingga pool dibuat. Jika tidak disertakan, pembuatan pool akan berjalan secara asinkron.--bandwidth-limitmenentukan jumlah bandwidth dalam MB/dtk yang akan disediakan untuk agen kumpulan ini. Batas bandwidth berlaku untuk semua agen dalam sebuah pool dan dapat membantu mencegah workload transfer pool mengganggu operasi lain yang menggunakan bandwidth Anda. Misalnya, masukkan '50' untuk menetapkan batas bandwidth sebesar 50 MB/dtk. Jika flag ini tidak ditentukan, agen pool ini akan menggunakan semua bandwidth yang tersedia untuk mereka.--display-nameadalah nama yang dapat diubah untuk membantu Anda mengidentifikasi pool ini. Anda dapat menyertakan detail yang mungkin tidak sesuai dengan nama resource lengkap unik pool.
Menetapkan agen ke kumpulan
Kumpulan agen baru masih kosong dan harus memiliki agen yang ditetapkan ke dalamnya. 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 pool:
Konsol Google Cloud
Dari halaman Agent pools, pilih pool untuk menetapkan agen.
Klik Install agent. Panduan Pemasangan Agen akan muncul.
Ikuti petunjuk untuk membuat agen di kumpulan agen ini.
gcloud CLI
Untuk menggunakan alat command line gcloud guna membuat agen dan menetapkannya ke
pool, jalankan gcloud transfer agents install. Agen harus diinstal di mesin 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 baik 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 Anda dapat ditetapkan ke tugas selama pembuatan atau pembaruan tugas.
Memperbarui kumpulan agen
Anda dapat memperbarui nama tampilan dan batas bandwidth kumpulan agen.
Untuk mengupdate kumpulan agen:
Konsol Google Cloud
Di konsol Google Cloud , buka halaman Agent pools.
Anda dapat mengedit item berikut:
Nama tampilan kumpulan agen: Klik Edit di samping nama Agent pool saat ini.
Batas bandwidth agen pool: Klik Set bandwidth limit, dan masukkan batas bandwidth baru di dialog Set bandwidth limit. Klik Set Limit untuk menerapkan batas bandwidth baru. Bandwidth digunakan bersama oleh semua agen dalam kumpulan.
REST API
Untuk mengupdate kumpulan agen, gunakan
projects.agentPools.patch
dengan mask kolom
dari kolom yang akan diupdate. Kolom kumpulan agen berikut dapat diupdate:
Misalnya, untuk memperbarui nama tampilan saja, tetapkan parameter kueri updateMask ke displayName dan berikan nilai baru dalam isi permintaan.
Berikut adalah contoh permintaan patch untuk memperbarui nama tampilan:
PATCH https://storagetransfer./v1/projects/PROJECT_ID/agentPools/AGENT_POOL?updateMask=displayName
{
"displayName": "NEW_DISPLAY_NAME"
}
Ganti kode berikut:
PROJECT_ID: Project ID tempat Anda mengupdate 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./v1/projects/PROJECT_ID/agentPools/AGENT_POOL?updateMask=bandwidthLimit
{
"bandwidthLimit": {
"limitMbps": "NEW_LIMIT"
}
}
Ganti kode berikut:
PROJECT_ID: Project ID tempat Anda mengupdate kumpulan agen.AGENT_POOL: ID pool agen yang Anda update.NEW_LIMIT: Batas bandwidth baru untuk kumpulan agen ini, dalam MBps (megabyte per detik).
gcloud CLI
Untuk menggunakan alat command line gcloud guna mengupdate agen pool, 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 pool ini.
AGENT_POOLmengidentifikasi kumpulan agen yang akan diupdate, dan tidak dapat diupdate sendiri.
Flag berikut dapat ditentukan dengan perintah ini:
--bandwidth-limitdapat diperbarui, atau dihapus dengan menentukan--clear-bandwidth-limit. Lihat Membuat kumpulan agen untuk mengetahui detail selengkapnya tentang batas bandwidth.--display-namedapat diperbarui, atau dihapus dengan flag--clear-display-name.
Menghapus kumpulan agen
Anda dapat menghapus kumpulan agen yang tidak memiliki agen aktif dan tidak memiliki tugas aktif yang berjalan.
Untuk menghapus kumpulan agen:
Konsol Google Cloud
Di konsol Google Cloud , buka halaman Agent pools.
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 pool ini.
REST API
Gunakan projects.agentPools.delete:
DELETE https://storagetransfer./v1/projects/PROJECT_ID/agentPools/AGENT_POOL
Ganti kode berikut:
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 pool ini.
Sebelum Anda dapat menghapus pool, semua agen di pool harus dihentikan, tugas pool harus dinonaktifkan, dan tidak boleh ada operasi transfer yang sedang berlangsung untuk pool ini.
Untuk melihat semua tugas yang terkait dengan kumpulan, pilih kumpulan Anda di konsol Google Cloud , lalu klik tab Transfer jobs.
Mendapatkan kumpulan agen
Untuk mendapatkan kumpulan agen:
Konsol Google Cloud
Di konsol Google Cloud , buka halaman Agent pools.
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 Name kumpulan agen.
Tindakan berikut tersedia dari halaman informasi kumpulan agen:
- Install agent: menampilkan petunjuk untuk menginstal agen Transfer.
- Menghentikan agen: Pilih agen dalam tabel, lalu klik Stop Agent.
- Mencantumkan tugas transfer: Klik Transfer Jobs untuk menampilkan agen tugas transfer yang terhubung ke kumpulan ini.
REST API
Gunakan projects.agentPools.get:
GET https://storagetransfer./v1/projects/PROJECT_ID/agentPools/AGENT_POOL
Ganti kode berikut:
PROJECT_ID: Project ID yang agent pool-nya Anda dapatkan.AGENT_POOL: Pool 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 pool ini.
Mencantumkan kumpulan agen
Untuk mencantumkan kumpulan agen Anda:
Konsol Google Cloud
Di konsol Google Cloud , buka halaman Agent pools.
Semua kumpulan agen akan ditampilkan.
REST API
Gunakan projects.agentPools.list:
GET https://storagetransfer./v1/projects/PROJECT_ID/agentPools
Ganti kode berikut:
PROJECT_ID: Project ID yang akan dicantumkan agent pool-nya.
gcloud CLI
Untuk menggunakan alat command line gcloud guna mencantumkan daftar 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:
--limitmenentukan jumlah maksimum kumpulan agen yang akan ditampilkan.--namesmenentukan nama kumpulan agen yang akan dicantumkan. Pisahkan beberapa nama dengan koma; misalnya,--names=foo,bar. Jika tidak ditentukan, semua kumpulan agen dalam project Anda saat ini akan dicantumkan.--page-sizemenentukan perilaku pengelompokan untuk perintah ini. Secara default, perintahlistmengelompokkan respons menjadi 256 item, yang otomatis mengambil batch berikutnya hingga semua item tercantum ataulimittercapai.
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