Anwendung bereitstellen und wieder entfernen

Nachdem Sie eine App erstellt haben, müssen Sie sie bereitstellen, um Daten streamen und analysieren zu können.

Anwendung bereitstellen

Nachdem Sie eine End-to-End-Anwendung mit allen erforderlichen Komponenten erstellt haben, müssen Sie die App bereitstellen, um sie verwenden zu können.

Console

1. Öffnen Sie den Tab Anwendungen des Vertex AI Vision-Dashboards.

   Zum Tab „Anwendungen“

2. Wählen Sie in der Liste neben dem Namen Ihrer Anwendung die Option App ansehen aus.

3. Klicken Sie auf der Seite „Application Graph Builder“ (Anwendungsgraph-Builder) auf die Schaltfläche Bereitstellen.

4. Wählen Sie im Menü Anwendung bereitstellen die gewünschten Optionen aus und klicken Sie auf Bereitstellen.

   Hinweis: Weitere Informationen zur Option Ausgabestreaming aktivieren finden Sie unter Livestreamausgabe aktivieren. Weitere Informationen zur Option Monitoring für diese Anwendung aktivieren finden Sie unter App-Monitoring aktivieren und verwenden.

   Nach Abschluss der Bereitstellung werden neben den Knoten grüne Häkchen angezeigt.

REST UND BEFEHLSZEILE

Wenn Sie Ihre Anwendung für die Nutzung bereitstellen möchten, senden Sie eine POST-Anfrage mit der Methode projects.locations.applications.deploy.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT: Ihre Google Cloud Projekt-ID oder Projektnummer.
• LOCATION_ID: Die Region, in der Sie Vertex AI Vision verwenden. Beispiel: us-central1, europe-west4. Weitere Informationen finden Sie unter Verfügbare Regionen.
• APPLICATION_ID: Die ID der Zielanwendung.

HTTP-Methode und URL:

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

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

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

Wenn die Anfrage erfolgreich ist, wird ein lang laufender Vorgang gestartet und ein JSON-Objekt mit der Vorgangs-ID zurückgegeben.

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
    "createTime": "YYYY-MM-DDTHH:MM:SS.454506987Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/applications/APPLICATION_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Vorgangsstatus abrufen

Verwenden Sie die Vorgangs-ID in der Antwort, um den Status der Bereitstellungsanfrage abzurufen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• REGIONALIZED_ENDPOINT: Der Endpunkt kann ein Präfix enthalten, das mit dem LOCATION_ID übereinstimmt, z. B. europe-west4-. Weitere Informationen zu regionalisierten Endpunkten
• PROJECT_NUMBER: Ihre Google Cloud Projektnummer.
• LOCATION_ID: Die Region, in der Sie Vertex AI Vision verwenden. Beispiel: us-central1, europe-west4. Weitere Informationen finden Sie unter Verfügbare Regionen.
• OPERATION_ID: Die Vorgangs-ID, die zurückgegeben wird, wenn Sie einen Vorgang mit langer Ausführungszeit starten. Beispiel:
  • projects/123456/locations/us-central1/[...]/operations/OPERATION_ID

HTTP-Methode und URL:

GET https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$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/operations/OPERATION_ID" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Antwort

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
    "createTime": "2023-01-12T17:53:14.454506987Z",
    "endTime": "2023-01-12T17:53:22.979720545Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/applications/APPLICATION_NAME",
    "verb": "update",
    "statusMessage": "Instance Deployment Pending....",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.Application",
    "name": "projects/PROJECT_ID/locations/LOCATION_ID/applications/APPLICATION_NAME",
    "createTime": "2023-01-06T21:16:26.465867295Z",
    "updateTime": "2023-01-12T17:53:14.458441937Z",
    "displayName": "APPLICATION_NAME",
    "applicationConfigs": {
      "nodes": [
        {
          "name": "builtin-input-stream",
          "displayName": "Streams",
          "nodeConfig": {
            "videoStreamInputConfig": {}
          },
          "processor": "builtin:stream-input",
          "outputAllOutputChannelsToStream": false
        },
        {
          "name": "builtin-general-object-detector",
          "displayName": "Object detector",
          "nodeConfig": {
            "generalObjectDetectionConfig": {}
          },
          "processor": "builtin:general-object-detector",
          "parents": [
            {
              "parentNode": "builtin-input-stream"
            }
          ],
          "outputAllOutputChannelsToStream": false
        },
        {
          "name": "builtin-media-warehouse",
          "displayName": "Vision AI Warehouse",
          "nodeConfig": {
            "mediaWarehouseConfig": {
              "corpus": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID"
            }
          },
          "processor": "builtin:media-warehouse",
          "parents": [
            {
              "parentNode": "builtin-input-stream"
            },
            {
              "parentNode": "builtin-general-object-detector"
            }
          ],
          "outputAllOutputChannelsToStream": false
        }
      ]
    },
    "runtimeInfo": {
      "deployTime": "2023-01-12T17:53:22.887918Z",
      "globalOutputResources": [
        {
          "outputResource": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID/dataSchemas/stream-resource-name",
          "key": "stream-resource-name"
        },
        {
          "outputResource": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID/dataSchemas/stream-display-name",
          "key": "stream-display-name"
        },
        {
          "outputResource": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID/dataSchemas/stream-resource-id",
          "key": "stream-resource-id"
        },
        {
          "outputResource": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID/dataSchemas/general-object-detection",
          "producerNode": "builtin-general-object-detector",
          "key": "general_object_detection_data_schema_id"
        }
      ]
    },
    "state": "DEPLOYED",
    "deploymentEnvironment": "DEPLOYMENT_ENVIRONMENT_CLOUD"
  }
}

Bereitstellung einer Anwendung aufheben

Wenn Sie eine App nicht mehr verwenden möchten, müssen Sie sie deinstallieren.

Console

1. Öffnen Sie den Tab Anwendungen des Vertex AI Vision-Dashboards.

   Zum Tab „Anwendungen“

2. Wählen Sie in der Liste neben dem Namen Ihrer Anwendung die Option App ansehen aus.

3. Klicken Sie auf der Seite „Anwendungsgraphen erstellen“ auf die Schaltfläche Deaktivieren.

REST UND BEFEHLSZEILE

Wenn Sie Ihre Anwendung deinstallieren möchten, senden Sie eine POST-Anfrage mit der Methode projects.locations.applications.undeploy.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT: Ihre Google Cloud Projekt-ID oder Projektnummer.
• LOCATION_ID: Die Region, in der Sie Vertex AI Vision verwenden. Beispiel: us-central1, europe-west4. Weitere Informationen finden Sie unter Verfügbare Regionen.
• APPLICATION_ID: Die ID der Zielanwendung.

HTTP-Methode und URL:

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

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

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

Wenn die Anfrage erfolgreich ist, wird ein lang laufender Vorgang gestartet und ein JSON-Objekt mit der Vorgangs-ID zurückgegeben.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
    "createTime": "2023-01-12T18:14:48.260296926Z",
    "target": "projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_NAME",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Vorgangsstatus abrufen

Verwenden Sie die Vorgangs-ID in der Antwort, um den Status der Deaktivierungsanfrage abzurufen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• REGIONALIZED_ENDPOINT: Der Endpunkt kann ein Präfix enthalten, das mit dem LOCATION_ID übereinstimmt, z. B. europe-west4-. Weitere Informationen zu regionalisierten Endpunkten
• PROJECT_NUMBER: Ihre Google Cloud Projektnummer.
• LOCATION_ID: Die Region, in der Sie Vertex AI Vision verwenden. Beispiel: us-central1, europe-west4. Weitere Informationen finden Sie unter Verfügbare Regionen.
• OPERATION_ID: Die Vorgangs-ID, die zurückgegeben wird, wenn Sie einen Vorgang mit langer Ausführungszeit starten. Beispiel:
  • projects/123456/locations/us-central1/[...]/operations/OPERATION_ID

HTTP-Methode und URL:

GET https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$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/operations/OPERATION_ID" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Antwort

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
    "createTime": "2023-01-12T18:14:48.260296926Z",
    "endTime": "2023-01-12T18:14:58.059563424Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/applications/APPLICATION_NAME",
    "verb": "update",
    "statusMessage": "Instance Undeployment Pending....",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.Application",
    "name": "projects/PROJECT_ID/locations/LOCATION_ID/applications/APPLICATION_NAME",
    "createTime": "2023-01-06T21:16:26.465867295Z",
    "updateTime": "2023-01-12T18:14:48.264089325Z",
    "displayName": "APPLICATION_NAME",
    "applicationConfigs": {
      "nodes": [
        {
          "name": "builtin-input-stream",
          "displayName": "Streams",
          "nodeConfig": {
            "videoStreamInputConfig": {}
          },
          "processor": "builtin:stream-input",
          "outputAllOutputChannelsToStream": false
        },
        {
          "name": "builtin-general-object-detector",
          "displayName": "Object detector",
          "nodeConfig": {
            "generalObjectDetectionConfig": {}
          },
          "processor": "builtin:general-object-detector",
          "parents": [
            {
              "parentNode": "builtin-input-stream"
            }
          ],
          "outputAllOutputChannelsToStream": false
        },
        {
          "name": "builtin-media-warehouse",
          "displayName": "Vision AI Warehouse",
          "nodeConfig": {
            "mediaWarehouseConfig": {
              "corpus": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPUS_ID"
            }
          },
          "processor": "builtin:media-warehouse",
          "parents": [
            {
              "parentNode": "builtin-input-stream"
            },
            {
              "parentNode": "builtin-general-object-detector"
            }
          ],
          "outputAllOutputChannelsToStream": false
        }
      ]
    },
    "state": "CREATED",
    "deploymentEnvironment": "DEPLOYMENT_ENVIRONMENT_CLOUD"
  }
}

Nächste Schritte

• Eine Anleitung zum Starten der Datenaufnahme aus dem Eingabestream einer App finden Sie unter Streams erstellen und verwalten.
• Weitere Informationen zum Auflisten von Apps und zum Aufrufen der Instanzen einer bereitgestellten App
• Informationen zum Lesen von App-Eingabedaten aus einem Datenaufnahmestream oder analysierten Modellausgabedaten finden Sie unter Streamdaten lesen.