Repository navigation
v0.0.94
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 withGET /cloud/linkand unlink withDELETE /cloud/link, each withconfig.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-inanswers the address to open, andGETon 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,/resumeand/run. Marfa stores the choice and the connector follows it, readingGET /plugins/{name}/connectoron 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, andMARFA_CLOUDFLARED, the path of the tunnel connector when it is not beside the server. Docs
CLI
- Added:
marfa cloud linkprints a code and an approval page and waits until the link is made,marfa cloud statusreads the link, andmarfa cloud unlinkends it or cancels one that waits for approval. Docs - Added:
marfa plugins sign-inprints the address to open to sign a plugin's connector in to its provider, and with--waitwaits for that sign-in to end. Docs - Added:
marfa plugins pause,resume,runandstatuscontrol a plugin's connector, andmarfa plugins mapping previewasks it for a preview, with--waitto read the answer. Docs
TypeScript SDK
- Added:
@withmarfa/clienttypes the Marfa Cloud link, connector sign-in, pause, resume, run now and mapping preview operations.
Full changelog: v0.0.93...v0.0.94