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 flow ke platform apa pun yang dapat menayangkan aplikasi Express.js, baik itu layanan cloud atau yang dihosting sendiri.

Halaman ini, sebagai contoh, akan memandu Anda melalui proses deployment alur contoh default.

  1. Instal alat yang diperlukan:

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

  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. Inisialisasi project nodejs:

    npm init -y

  4. Lakukan inisialisasi project Genkit:

    genkit init

    1. Pilih Node.js sebagai opsi platform deployment (template untuk Firebase Cloud Functions dan Google Cloud Run juga tersedia).

    2. Pilih model Anda:

      Gemini (AI Google)

      Cara paling sederhana untuk memulai adalah dengan Google AI Gemini API. Pastikan software tersebut tersedia di wilayah Anda.

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

      export GOOGLE_API_KEY=<your API key>

      Gemini (Vertex AI)

      Jika Google AI Gemini API tidak tersedia di wilayah Anda, pertimbangkan untuk menggunakan Vertex AI API yang juga menawarkan Gemini dan model lainnya. Anda harus memiliki project Google Cloud yang mendukung penagihan, mengaktifkan AI Platform API, dan 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.

    3. 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 alurnya 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 ke penyedia pilihan Anda. Detailnya akan bergantung pada penyedia, tetapi umumnya, Anda perlu mengonfigurasi setelan berikut:

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