Creating your first action

An action is defined by a Transposit Developer Platform application and implements a functionality end-to-end (E.g. merge a change on Jenkins, get the last 10 git commits, update the StatusPage incident page, etc.) You may also need to set up authorization and some configuration in order for the application to run.

An action can be triggered with authentication and environment variables in a runbook. When you create an action application, you are creating a action that can be added to any runbook.

This tutorial will guide you to make your first action in Python. JavaScript support is also available.

Creating your first action#

  1. Fork sample application: Go to this sample application and click "Fork this app" at the top of the page. Make sure to change the owner to the name of your team, not your personal account.
  2. Deploy application: In your application in the Transposit Developer Platform, go to Deploy > Mission Control and select your input (named input_prompt) and execution operations (named execute_wrapper). The type should be "Action". You should use the latest tag for ease of development.
  3. Create a runbook: Go back to the main Transposit site. In the top navigation, go to the Runbooks section. Create a New runbook.
  4. Add the action: Select + Add to add a step and give it a name, then add an + Action. Select My Applications and select the application you just created and input any environment variables (if needed). Your application needs to be deployed to show up in the application picker. If you don’t see it, make sure you completed Step 2. Make sure to Save your runbook!
  5. Test your acton: Click on the top Runbooks tab. Find your runbook, expand the ... menu, and click Run.

If you make a changes to a runbook, you'll need to start a new runbook run (Step 5) to pick up the changes. In Slack, use /transposit to browse and start runbooks.

If you want to better understand the operations that actions use, learn error handling best practices, learn more about authentication, and more action concepts, see our Action concepts & best practices doc.