Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menginstal plugin kustom
Alur Kerja Terkelola Amazon untuk Apache Airflow mendukung pengelola plugin bawaan Apache Airflow, memungkinkan Anda menggunakan operator, kait, sensor, atau antarmuka Apache Airflow khusus. Halaman ini menjelaskan langkah-langkah untuk menginstal plugin kustom Apache Airflowplugins.zip
Daftar Isi
Prasyarat
Anda akan memerlukan yang berikut ini sebelum Anda dapat menyelesaikan langkah-langkah di halaman ini.
-
Izin — AWS Akun Anda harus telah diberikan akses oleh administrator Anda ke kebijakan kontrol mazonMWAAFull ConsoleAccess akses A untuk lingkungan Anda. Selain itu, MWAA lingkungan Amazon Anda harus diizinkan oleh peran eksekusi Anda untuk mengakses AWS sumber daya yang digunakan oleh lingkungan Anda.
-
Akses — Jika Anda memerlukan akses ke repositori publik untuk menginstal dependensi langsung di server web, lingkungan Anda harus dikonfigurasi dengan akses server web jaringan publik. Untuk informasi selengkapnya, lihat Mode akses Apache Airflow.
-
Konfigurasi Amazon S3 - Bucket Amazon S3 yang digunakan untuk menyimpan plugin kustom DAGs Anda
plugins.zip
, dan dependensi Python harus dikonfigurasi dengan Akses Publik Diblokir danrequirements.txt
Diaktifkan Versi.
Cara kerjanya
Untuk menjalankan plugin khusus di lingkungan Anda, Anda harus melakukan tiga hal:
-
Buat
plugins.zip
file secara lokal. -
Unggah
plugins.zip
file lokal ke bucket Amazon S3 Anda. -
Tentukan versi file ini di bidang file Plugins di MWAA konsol Amazon.
catatan
Jika ini adalah pertama kalinya Anda mengunggah plugins.zip
ke bucket Amazon S3 Anda, Anda juga perlu menentukan jalur ke file di konsol AmazonMWAA. Anda hanya perlu menyelesaikan langkah ini sekali.
Kapan menggunakan plugin
Plugin hanya diperlukan untuk memperluas antarmuka pengguna Apache Airflow, seperti yang diuraikan dalam dokumentasi Apache Airflow./dags
folder di samping DAG
kode Anda.
Jika Anda perlu membuat integrasi Anda sendiri dengan sistem eksternal, letakkan di dags
folder/atau subfolder di dalamnya, tetapi tidak di plugins.zip
folder. Di Apache Airflow 2.x, plugin terutama digunakan untuk memperluas UI.
Demikian pula, dependensi lain tidak boleh ditempatkan di. plugins.zip
Sebagai gantinya, mereka dapat disimpan di lokasi di bawah /dags
folder Amazon S3, di mana mereka akan disinkronkan ke setiap MWAA wadah Amazon sebelum Apache Airflow dimulai.
catatan
File apa pun di /dags
folder atau plugins.zip
yang tidak secara eksplisit mendefinisikan DAG objek Apache Airflow harus terdaftar dalam file. .airflowignore
Ikhtisar plugin kustom
Manajer plugin bawaan Apache Airflow dapat mengintegrasikan fitur eksternal ke intinya hanya dengan menjatuhkan file ke dalam folder. $AIRFLOW_HOME/plugins
Ini memungkinkan Anda untuk menggunakan operator, kait, sensor, atau antarmuka Apache Airflow khusus. Bagian berikut memberikan contoh struktur direktori datar dan bersarang di lingkungan pengembangan lokal dan pernyataan impor yang dihasilkan, yang menentukan struktur direktori dalam plugins.zip.
Direktori plugin kustom dan batas ukuran
Penjadwal Aliran Udara Apache dan Pekerja mencari plugin khusus selama startup pada wadah AWS Fargate yang dikelola untuk lingkungan Anda di. /usr/local/airflow/plugins/
*
-
Struktur direktori. Struktur direktori (at
/
) didasarkan pada isi*
plugins.zip
file Anda. Misalnya, jika Andaplugins.zip
berisioperators
direktori sebagai direktori tingkat atas, maka direktori akan diekstraksi ke lingkungan/usr/local/airflow/plugins/
Anda.operators
-
Batas ukuran. Kami merekomendasikan
plugins.zip
file kurang dari 1 GB. Semakin besar ukuranplugins.zip
file, semakin lama waktu startup pada suatu lingkungan. Meskipun Amazon MWAA tidak membatasi ukuranplugins.zip
file secara eksplisit, jika dependensi tidak dapat diinstal dalam waktu sepuluh menit, layanan Fargate akan habis waktu dan mencoba mengembalikan lingkungan ke status stabil.
catatan
Untuk lingkungan yang menggunakan Apache Airflow v1.10.12 atau Apache Airflow v2.0.2, Amazon MWAA membatasi lalu lintas keluar di server web Apache Airflow, dan tidak memungkinkan Anda untuk menginstal plugin atau dependensi Python langsung di server web. Dimulai dengan Apache Airflow v2.2.2, MWAA Amazon dapat menginstal plugin dan dependensi langsung di server web.
Contoh plugin kustom
Bagian berikut menggunakan kode contoh dalam panduan referensi Apache Airflow untuk menunjukkan cara menyusun lingkungan pengembangan lokal Anda.
Contoh menggunakan struktur direktori datar di plugins.zip
Contoh menggunakan struktur direktori bersarang di plugins.zip
Membuat file plugins.zip
Langkah-langkah berikut menjelaskan langkah-langkah yang kami sarankan untuk membuat file plugins.zip secara lokal.
Langkah satu: Uji plugin khusus menggunakan utilitas Amazon MWAA CLI
-
Utilitas antarmuka baris perintah (CLI) mereplikasi Alur Kerja Terkelola Amazon untuk lingkungan Apache Airflow secara lokal.
-
CLIMembangun image container Docker secara lokal yang mirip dengan image produksi AmazonMWAA. Ini memungkinkan Anda menjalankan lingkungan Apache Airflow lokal untuk mengembangkan dan mengujiDAGs, plugin khusus, dan dependensi sebelum menerapkan ke Amazon. MWAA
-
Untuk menjalankanCLI, lihat aws-mwaa-local-runner
di GitHub.
Langkah kedua: Buat file plugins.zip
Anda dapat menggunakan utilitas ZIP arsip bawaan, atau ZIP utilitas lainnya (seperti 7zip
catatan
Utilitas zip bawaan untuk OS Windows dapat menambahkan subfolder saat Anda membuat file.zip. Sebaiknya verifikasi konten file plugins.zip sebelum mengunggah ke bucket Amazon S3 Anda untuk memastikan tidak ada direktori tambahan yang ditambahkan.
-
Ubah direktori ke direktori plugin Airflow lokal Anda. Sebagai contoh:
myproject$
cd plugins
-
Jalankan perintah berikut untuk memastikan bahwa konten memiliki izin yang dapat dieksekusi (hanya macOS dan Linux).
plugins$
chmod -R 755 .
-
Zip konten di dalam
plugins
folder Anda.plugins$
zip -r plugins.zip .
Mengunggah plugins.zip
ke Amazon S3
Anda dapat menggunakan konsol Amazon S3 atau AWS Command Line Interface (AWS CLI) untuk mengunggah plugins.zip
file ke bucket Amazon S3 Anda.
Menggunakan AWS CLI
The AWS Command Line Interface (AWS CLI) adalah alat open source yang memungkinkan Anda berinteraksi dengan AWS layanan menggunakan perintah di shell baris perintah Anda. Untuk menyelesaikan langkah-langkah di halaman ini, Anda memerlukan yang berikut:
Untuk mengunggah menggunakan AWS CLI
-
Di prompt perintah Anda, arahkan ke direktori tempat
plugins.zip
file Anda disimpan. Sebagai contoh:cd plugins
-
Gunakan perintah berikut untuk membuat daftar semua bucket Amazon S3 Anda.
aws s3 ls
-
Gunakan perintah berikut untuk mencantumkan file dan folder di bucket Amazon S3 untuk lingkungan Anda.
aws s3 ls s3://
YOUR_S3_BUCKET_NAME
-
Gunakan perintah berikut untuk mengunggah
plugins.zip
file ke bucket Amazon S3 untuk lingkungan Anda.aws s3 cp plugins.zip s3://
YOUR_S3_BUCKET_NAME
/plugins.zip
Menggunakan konsol Amazon S3
Konsol Amazon S3 adalah antarmuka pengguna berbasis web yang memungkinkan Anda membuat dan mengelola sumber daya di bucket Amazon S3 Anda.
Untuk mengunggah menggunakan konsol Amazon S3
-
Buka halaman Lingkungan
di MWAA konsol Amazon. -
Pilih lingkungan.
-
Pilih tautan bucket S3 di DAGkode di panel S3 untuk membuka bucket penyimpanan Anda di konsol Amazon S3.
-
Pilih Unggah.
-
Pilih Tambahkan file.
-
Pilih salinan lokal Anda
plugins.zip
, pilih Unggah.
Menginstal plugin khusus di lingkungan Anda
Bagian ini menjelaskan cara menginstal plugin khusus yang Anda unggah ke bucket Amazon S3 Anda dengan menentukan jalur ke file plugins.zip, dan menentukan versi file plugins.zip setiap kali file zip diperbarui.
Menentukan jalur ke MWAA konsol plugins.zip
Amazon (pertama kali)
Jika ini adalah pertama kalinya Anda mengunggah plugins.zip
ke bucket Amazon S3 Anda, Anda juga perlu menentukan jalur ke file di konsol AmazonMWAA. Anda hanya perlu menyelesaikan langkah ini sekali.
-
Buka halaman Lingkungan
di MWAA konsol Amazon. -
Pilih lingkungan.
-
Pilih Edit.
-
Pada DAGkode di panel Amazon S3, pilih Browse S3 di sebelah file Plugins - bidang opsional.
-
Pilih
plugins.zip
file di bucket Amazon S3 Anda. -
Pilih Tutup.
-
Pilih Berikutnya, Perbarui lingkungan.
Menentukan plugins.zip
versi di konsol Amazon MWAA
Anda perlu menentukan versi plugins.zip
file Anda di MWAA konsol Amazon setiap kali Anda mengunggah versi baru Anda plugins.zip
di bucket Amazon S3 Anda.
-
Buka halaman Lingkungan
di MWAA konsol Amazon. -
Pilih lingkungan.
-
Pilih Edit.
-
Pada DAGkode di panel Amazon S3, pilih
plugins.zip
versi dalam daftar dropdown. -
Pilih Berikutnya.
Contoh kasus penggunaan untuk plugins.zip
-
Pelajari cara membuat plugin khusus diPlugin kustom dengan Apache Hive dan Hadoop.
-
Pelajari cara membuat plugin khusus diPlugin kustom untuk menambal PythonVirtualenvOperator .
-
Pelajari cara membuat plugin khusus diPlugin kustom dengan Oracle.
-
Pelajari cara membuat plugin khusus diMengubah zona waktu a DAG di Amazon MWAA.
Apa selanjutnya?
-
UjiDAGs, plugin kustom, dan dependensi Python Anda secara lokal menggunakan on. aws-mwaa-local-runner
GitHub