Men-deploy alur ke platform Node.js mana pun

Firebase Genkit memiliki integrasi bawaan yang membantu Anda men-deploy alur ke Firebase Cloud Functions dan Google Cloud Run, tetapi Anda juga dapat men-deploy mengalir ke platform apa pun yang dapat melayani aplikasi Express.js, baik itu cloud yang dihosting sendiri atau dihosting sendiri.

Halaman ini, misalnya, akan memandu Anda dalam proses men-deploy paket default alur sampel.

  1. Instal alat yang diperlukan:

    • Pastikan Anda menggunakan node versi 20 atau yang lebih tinggi (jalankan node --version untuk ).

  2. Buat direktori untuk project contoh Genkit:

    export GENKIT_PROJECT_HOME=~/tmp/genkit-express-project
mkdir -p $GENKIT_PROJECT_HOME
cd $GENKIT_PROJECT_HOME

    Jika Anda akan menggunakan IDE, buka direktori ini.

  3. Lakukan inisialisasi project nodejs:

    npm init -y

  4. Inisialisasi project Genkit:

    genkit init

    1. Pilih model Anda:

      Gemini (AI Google)

      Cara termudah untuk memulai adalah menggunakan Gemini API AI Google. Pastikan Gemini API AI Google tersedia di region Anda.

      Buat kunci API untuk Gemini API menggunakan Google AI Studio. Lalu, tetapkan variabel lingkungan GOOGLE_API_KEY ke kunci Anda:

      export GOOGLE_API_KEY=<your API key>

      Gemini (Vertex AI)

      Jika Gemini API AI Google tidak tersedia di region Anda, pertimbangkan menggunakan API Vertex AI yang juga menawarkan Gemini dan model lainnya. Anda harus memiliki project Google Cloud yang mendukung penagihan, mengaktifkan API AI Platform, lalu menetapkan beberapa variabel lingkungan tambahan:

      gcloud services enable aiplatform.googleapis.com
export GCLOUD_PROJECT=<your project ID>
export GCLOUD_LOCATION=us-central1

      Lihat https://cloud.google.com/vertex-ai/generative-ai/pricing untuk mengetahui harga Vertex AI.

    2. Pilih jawaban default untuk pertanyaan lainnya, yang akan menginisialisasi folder project Anda dengan beberapa kode contoh.

  5. Build dan jalankan kode contoh:

    npm run build
genkit flow:run menuSuggestionFlow "\"banana\"" -s

  6. Opsional: Mulai UI developer:

    genkit start

    Kemudian, buka http://localhost:4000/flows dan jalankan alur menggunakan UI developer.

    Setelah selesai, tekan Ctrl+C di konsol untuk keluar dari UI.

  7. Coba endpoint Express:

    npm run start

    Kemudian, di jendela lain:

    curl -X POST "http://127.0.0.1:3400/menuSuggestionFlow?stream=true" -H "Content-Type: application/json"  -d '{"data": "banana"}'

  8. Jika semuanya berfungsi seperti yang diharapkan, Anda dapat men-deploy alur tersebut ke penyedia pilihan Anda. Detailnya akan bergantung pada penyedia, tetapi umumnya, Anda memerlukan untuk mengonfigurasi setelan berikut:

    Setelan Nilai
    Runtime Node.js 20 atau yang lebih baru
    Perintah build npm run build
    Mulai perintah npm run start
    Variabel lingkungan GOOGLE_API_KEY=<your-api-key> (atau rahasia mana pun yang diperlukan)