Skip to content

v0.0.94

Choose a tag to compare

@github-actions github-actions released this 22 Nov 10:58
3383e32

An owner can now link an instance to Marfa Cloud, which is in alpha, to give it a public name and address, sign a plugin's connector in to its provider through a browser, and pause a connector, run it now or preview its mapping.

Server

  • Added: An owner can link an instance to Marfa Cloud with POST /cloud/link, read the link with GET /cloud/link and unlink with DELETE /cloud/link, each with config.manage. A linked instance answers at its Marfa Cloud name through the tunnel connector each release carries, which runs only while the instance is linked. Nothing is sent to Marfa Cloud until the owner starts a link. Marfa Cloud is in alpha and sign-up is by invitation. Docs
  • Added: Linking moves the sign-in address to the Marfa Cloud name by default, once you confirm it, and unlinking puts the earlier address back. A key cannot confirm the move, so with a key the link is made and the move waits, and the link's status names the next step. "sign_in_address": "keep" leaves the address where it is.
  • Added: A plugin's connector that declares a sign-in can get its refresh token through the owner's browser, with the owner's own OAuth client ID and secret kept in the plugin's settings. POST /plugins/{name}/connector/sign-in answers the address to open, and GET on the same path reads how the sign-in ended, with a fixed reason word when it failed. Marfa calls the provider only to finish a sign-in the owner started. Docs
  • Added: An owner can pause a plugin's connector, resume it and ask it to run now with POST /plugins/{name}/connector/pause, /resume and /run. Marfa stores the choice and the connector follows it, reading GET /plugins/{name}/connector on each run. A paused connector's key still writes, so a run under way finishes. Docs
  • Added: An owner can ask a plugin's connector for a preview of how one kind would land under its mapping, or under a draft of it, with POST /plugins/{name}/connector/previews. A preview lasts 10 minutes, and a plugin holds at most 20. Docs
  • Added: The start-only settings MARFA_CLOUD_URL, the Marfa Cloud service an instance links to, and MARFA_CLOUDFLARED, the path of the tunnel connector when it is not beside the server. Docs

CLI

  • Added: marfa cloud link prints a code and an approval page and waits until the link is made, marfa cloud status reads the link, and marfa cloud unlink ends it or cancels one that waits for approval. Docs
  • Added: marfa plugins sign-in prints the address to open to sign a plugin's connector in to its provider, and with --wait waits for that sign-in to end. Docs
  • Added: marfa plugins pause, resume, run and status control a plugin's connector, and marfa plugins mapping preview asks it for a preview, with --wait to read the answer. Docs

TypeScript SDK

  • Added: @withmarfa/client types the Marfa Cloud link, connector sign-in, pause, resume, run now and mapping preview operations.

Full changelog: v0.0.93...v0.0.94