Skip to main content

Quickstart: Service Invocation

This quickstart showcases how to enable the request-reply pattern using the Service Invocation API.

invoke qs

Prerequisites

Before you proceed, ensure you have the following prereqs installed.

Log in to Catalyst

Authenticate to Diagrid Catalyst using the following command:

diagrid login

Confirm your organization and user details are correct:

diagrid whoami

Clone quickstart code

Clone the quickstart code from the Diagrid Labs GitHub repository and navigate to the appropriate directory:

diagrid dev quickstart --type invoke --language python

Run quickstart application

To run the quickstart locally, use the diagrid dev run command. This command uses the dapr multi-app run file in the root of the code directory to:

  • Provision a Catalyst project: If the project does not exist, the command will create a new project
  • Create resources: Creates the necessary resources on Catalyst such as App IDs, Components, and Diagrid Pub/Sub or KV Store managed services
  • Launch the quickstart applications: Locates the code directories using the values specified for workDir and launches each application using the app command inputs
  • Inject environment variables: Configures the Dapr client to talk to Catalyst using the client App ID API token
  • Establish Catalyst connectivity: Creates a private dev tunnel for the server application on the specified appPort, which will route all traffic destined for the server App ID to the local port where the code is running

For additional details on the Catalyst local development experience, read Develop Locally with Catalyst APIs.

Restore .NET package dependencies required by each service:

dotnet restore ./client && dotnet restore ./server

Run your applications and connect the server App ID to the local server app using the following command.

diagrid dev run -f dev-python-invocation.yaml --project dev-python-invocation
tip

Ensure the log Connected App ID "server" to localhost:5002 appears before proceeding to the next section.

Interact with Catalyst APIs

With your applications now successfully running, it's time to test the Service Invocation API. Use the curl command below or take advantage of the REST Client extension using Visual Studio Code with the test.rest file in the root folder of the repo.

Open a new terminal and execute the following curl command:

curl -i -X POST http://localhost:5001/order -H "Content-Type: application/json" -d '{"orderId":1}'

Upon successful execution, the server app should indicate the request was successfully received and the client app logs should output the invocation was successful.

logs

To stop the local applications and disconnect the local app connection for the server App ID, run:

diagrid dev stop

Clean up resources

If you are not going to continue to use this application, you can delete the resoures using the following commands:

diagrid appid delete client
diagrid appid delete server

If you want to delete the entire Catalyst project, including the managed infrastructure resources, run the diagrid project delete command.