Skip to content

command-trigger.md

Latest commit

 

History

History
114 lines (75 loc) · 3.82 KB

command-trigger.md

File metadata and controls

114 lines (75 loc) · 3.82 KB
Raw

title = "The Spin Command Trigger" template = "spin_main" date = "2025-01-09T00:00:01Z" enable_shortcodes = true [extra] url = "https://github.com/fermyon/developer/blob/main/content/spin/v3/command-trigger.md"

Spin has experimental support for creating and running components once. Please note that there are only working Command trigger app samples written in Rust at present.

Please note: You can not spin deploy an application to Fermyon Cloud if it uses command because non-HTTP triggers are not supported in Fermyon Cloud.

Let's look at how the experimental Command trigger for Spin allows you to deploy an application that runs once to completion. The Command trigger specification references a specific component. For example:

[[trigger.command]]
component = "hello"

Installing the Command Trigger

Installing the Command Trigger Plugin

First, we install the plugin:

spin plugins update
spin plugin install trigger-command

Installing the Command Trigger Template

Then, we install the template:

spin templates install --git https://github.com/fermyon/spin-trigger-command

Creating the Application

With the plugin and template installed, we create a new application:

spin new -t command-rust hello --accept-defaults

Inspecting the Source Code

The Rust source code for this application is as follows:

fn main() {
    println!("Hello, Fermyon!");
}

Building and Running the Application

We can immediately run this pre-written (template) application and observe the time-driven execution:

cd hello
spin build --up

Building component hello with `cargo build --target wasm32-wasi --release`

...

Finished building all Spin components

Hello, Fermyon!

As we can see from the above output, our application is executed once to completion without the need for any incoming requests.

Learn more about the Spin Command Trigger

<iframe width="560" height="315" src="https://www.youtube.com/embed/l2nh_xpjCiM?si=fBPaiqoIkJPQ95W_" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

If you would like to learn more about using the Spin Command Trigger, please check out the Spin Command Trigger GitHub repository.

Additional Spin Triggers

You can leverage different triggers as part of your Spin apps to address common requirements and build real-world, distributed applications with Spin.

Common Triggers

Community Triggers

The incredible Spin and SpinKube community, also provides the following, additional Spin triggers: