Mengelola instance aplikasi

Setelah mem-build dan men-deploy aplikasi, Anda dapat mengelola instance aplikasi ini menggunakan konsol atau command line Google Cloud.

Melihat instance dan output aplikasi yang di-deploy

Anda dapat melihat instance dan output aplikasi menggunakan konsol Google Cloud atau command line. Kemudian, Anda dapat menggunakan informasi ini untuk membaca aliran output model dan mendapatkan aset.

UI Web

Melihat instance dan output aplikasi di konsol Google Cloud.

  1. Buka tab Applications di dasbor Vertex AI Vision.

    Buka tab Applications

  2. Pilih nama aplikasi yang ingin Anda lihat. Tindakan ini akan mengarahkan Anda ke halaman detail aplikasi.

    Halaman detail aplikasi menampilkan tabel dengan resource aplikasi. Tabel ini mencantumkan semua instance aplikasi yang sedang berjalan. Setiap streaming input ke aplikasi memiliki instance-nya sendiri. Setiap instance memiliki resource input dan outputnya sendiri yang tercantum di bawahnya.

    gambar halaman detail resource aplikasi

  3. Untuk memeriksa resource aset streaming atau warehouse di tabel instance, klik ID input atau output, atau pilih jalur.

    • Jika mengklik resource stream, Anda akan dialihkan ke halaman detail stream, tempat Anda dapat memeriksa informasi mendetail tentang stream tersebut.

      Untuk mempelajari cara membaca aliran output model menggunakan command line, lihat Membuat dan mengelola Aliran Data.

      gambar detail resource streaming

    • Mengklik resource aset gudang akan mengarahkan Anda ke halaman detail aset Vision Warehouse.

      Untuk mendapatkan aset Vision Warehouse, lihat Mengelola resource menggunakan Vision Warehouse API.

      gambar detail resource warehouse

REST

Untuk menampilkan daftar instance aplikasi, kirim permintaan GET menggunakan metode projects.locations.applications.instances.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

Metode HTTP dan URL: 

GET https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances"

PowerShell

Jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "instances": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances/INSTANCE_ID",
      "createTime": "2022-03-01T20:05:45.863836157Z",
      "inputResources": [
        {
          "inputResource": "input-stream",
          "consumerNode": "builtin-input-stream"
        }
      ],
      "outputResources": [
        {
          "outputResource": "sample-resource-1",
          "producerNode": "builtin-occupancy-count",
          "isTemporary": true
        },
        {
          "outputResource": "sample-resource-2",
          "producerNode": "builtin-input-stream"
        },
        {
          "outputResource": "sample-resource-3",
          "producerNode": "builtin-input-stream",
          "isTemporary": true
        },
        {
          "outputResource": "sample-resource-4",
          "producerNode": "builtin-input-stream",
          "isTemporary": true
        }
      ]
    }
  ]
}

Menghapus instance aplikasi

REST

Untuk menghapus instance aplikasi, kirim permintaan POST menggunakan metode projects.locations.applications.deleteApplicationInstances.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_NUMBER: Nomor project Google CloudAnda.
  • LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
  • APPLICATION_ID: ID aplikasi target Anda.

Metode HTTP dan URL: 

POST https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deleteApplicationInstances

Isi JSON permintaan: 

{
  "instanceIds": [
    "INSTANCE_ID1",
    "INSTANCE_ID2",
    [...]
  ]
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deleteApplicationInstances"

PowerShell

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deleteApplicationInstances" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
    "createTime": "[...]",
    "Target": "projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID"
    "Verb": "update"
    "apiVersion": "v1"
  },
  "done": false
}

Mengelola aplikasi skala besar

Metode deployment dan undeployment valid untuk aplikasi dengan kurang dari 20 instance. Jika aplikasi Anda memiliki lebih dari 20 instance, Anda harus membuat dan menghapus instance secara bertahap dengan API. Alur kerja yang direkomendasikan adalah sebagai berikut:

  1. Buat aplikasi Anda.
  2. Tambahkan 1-20 instance eksperimental.
  3. Deploy aplikasi Anda.
  4. Verifikasi bahwa aplikasi Anda berfungsi seperti yang diharapkan.
  5. Gunakan metode createApplicationInstances untuk menambahkan input lainnya secara bertahap ke aplikasi yang di-deploy.
  6. Mengizinkan aplikasi berjalan.
  7. Gunakan metode deleteApplicationInstances untuk menghapus input secara bertahap dari aplikasi yang di-deploy.
  8. Batalkan deployment aplikasi.