Running a Structure
Once your Structure is created and deployed, you can run your Structure one of three ways outlined below. You may view the details of any of your runs, no matter how you created them, in the Runs
tab of your Structure.
To learn more about Structure Run details and output, look at the Structure Run Events documentation.
From the Cloud Console
In the cloud console, click on the name of the Structure you wish to run and then go to the Test
tab. Here you can specify arguments to pass to your Structure run and any run-specific environment variables you need.
When passing arguments through the cloud console, pass each new argument on a new line. For example if your local code is ran with the inputs -i input_file.txt
then the arguments you would pass in the cloud would be:
From the API
You can run your Structure via the API using cURL or any other code that can make HTTP requests. You will need a Griptape Cloud API Key and the Structure Invocation URL
which is located on the Config
tab of your Structure.
The example below will kick off a run with the args you pass as a json object.
export GT_CLOUD_API_KEY=<your API key here>
export INVOCATION_URL=<your structure invocation URL>
curl -H "Authorization: Bearer ${GT_CLOUD_API_KEY}" --json '{"args": ["arg1"], "env_vars": [{"name":"var1", "value": "value"}]}' ${INVOCATION_URL}
For more information on other Structure run APIs, check out the StructureRuns API docs.
Using the Griptape Framework
You can use StructureRunDrivers to run your Structure with Griptape.