Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/thorstenhans/fermyon-tasks-az-devops

Last synced: 9 days ago
JSON representation

Host: GitHub
URL: https://github.com/thorstenhans/fermyon-tasks-az-devops
Owner: ThorstenHans
License: mit
Created: 2023-11-10T15:28:06.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2023-11-10T15:32:32.000Z (about 1 year ago)
Last Synced: 2024-04-14T04:43:55.660Z (7 months ago)
Language: TypeScript
Size: 1.2 MB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Spin & Fermyon Cloud tasks for Azure DevOps

This is a collection of tools for Azure DevOps Pipelines to work with Fermyon Spin & Fermyon Cloud. Tools have been build and tested for Linux, macOS and Windows agents. Currently, `spin` is downloaded for the `amd64` architecture only.

![Spin & Fermyon Cloud Tasks](assets/docs/fermyon-tasks.png)

## Spin Tool Installer

The *Spin Tool Installer* allows you to install any version of the `spin` CLI on your Azure DevOps Agent. By default, the task will download the **latest** version of `spin`. You can specify a different version by setting the `version` input variable as shown in the following figure:

![Spin Tool Installer Task - Version](assets/docs/spin-tool-installer-version.png)

```yaml
- task: thorstenhans.fermyon.spin-tool.spin-tool@0
displayName: 'Install Fermyon Spin'
inputs:
version: v2.0.0
```

## Spin Build

The *Spin Build* task invokes `spin build` to compile your Spin application.

```yaml
- task: thorstenhans.fermyon.spin-build.spin-build@0
displayName: 'Spin Build'
```

## Spin Command

The *Spin Command* tool allows users to invoke any command provided by `spin` CLI or its plugins. Users have to specify the `command` input variable. Optional arguments can be provided using the `arguments` input variable. One should separate arguments using a newline character (`\n`). The following figure shows an example of the *Spin Command* task:

![Spin Command Task - Example](assets/docs/spin-command-example.png)

```yaml
steps:
- task: thorstenhans.fermyon.spin-command.spin-command@0
displayName: 'List all spin apps in Fermyon Cloud'
inputs:
command: cloud
arguments: |
apps
list
```

## Spin Version

Use the *Spin Version* task retrieve the version of the `spin` tool installed on the agent. The task provides an output variable called `version` that could be referenced from within other tasks. Remember to specify the *Reference Name* of the *Spin Version* task as shown in the following figure:

![Spin Version Task - Output Variables](assets/docs/spin-version-output.png)

Tasks can reference the output variable using the `$(.version)` syntax.

## Deploy to Fermyon Cloud

The *Deploy to Fermyon Cloud* task allows you to deploy your Spin application to Fermyon Cloud. The task requires a valid Fermyon Cloud account and a valid Spin application. To authenticate with Fermyon Cloud, you must generate a Personal Access Token (PAT) in your [Fermyon Cloud account](https://cloud.fermyon.com). Treat the PAT as sensitive information and store it as masked (sensitive) pipeline variable. (variable groups in Azure DevOps support this too).

![Deploy to Fermyon Cloud](assets/docs/deploy-to-fermyon-cloud.png)

```yaml
steps:
- task: thorstenhans.fermyon.deploy-to-fermyon-cloud.deploy-to-fermyon-cloud@0
displayName: 'Deploy to Fermyon Cloud'
inputs:
token: '$(fermyon.cloud.token)'
```