Connections menjaga credential provider di luar Job dan memungkinkan transfer server-to-server. Import eksternal dinormalisasi menjadi File milik ConverterHQ sebelum konversi; output dapat dikirim ke provider mana pun yang didukung.
Connections
Secret dienkripsi dan tidak pernah dikembalikan. Uji POST /v1/connections/{id}/test sebelum produksi dan rotasi atau cabut Connection daripada menyalin secret ke Job.
Input kanonik
import/s3, import/gcs, import/azure, dan import/sftp mengambil sumber lalu menyimpannya sebagai File ConverterHQ. Task konversi membaca File ini agar retry, retensi, checksum, dan ownership konsisten.
Output multi-cloud
Hasil adalah File ConverterHQ yang dapat diekspor dengan export/s3, export/gcs, export/azure, atau export/sftp. Provider input dan output tidak harus sama.
Keamanan S3
Untuk S3, utamakan AssumeRole dengan ExternalId dan batasi role ke bucket serta prefix yang diperlukan.
Import/export Tasks
Kontrak DAG konsisten: import menghasilkan File dan export menggunakan File. Side effect eksternal dicheckpoint agar export dengan hasil tidak pasti tidak diulang diam-diam.
Penanganan kegagalan
Error autentikasi, objek hilang, dan izin bersifat deterministik sampai kondisi eksternal berubah. Periksa error Task dan uji Connection sebelum retry.