Service: Temporal - EyevinnOSC/community GitHub Wiki

Temporal

Temporal (serviceId temporalio-temporal) is an open source durable execution platform for building reliable, fault-tolerant applications. It handles retries, timeouts, state persistence and failure recovery, so distributed workflows can be written as ordinary code. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance. License: MIT. Source: temporalio/temporal.

What it can do

  • Run long-running business processes, data pipelines, order management and other workflows where partial failure must be handled correctly.
  • Provide the Temporal Web UI at the instance URL (no login by default) to browse namespaces and workflow executions, inspect history and event timelines, search workflows by status, type or time range, and terminate or reset stuck workflows.
  • Accept connections from Temporal SDK clients (for example TypeScript and Python) on port 7233 of the instance hostname.

Creating an instance

Create the database first and confirm it is running: a PostgreSQL instance (serviceId birme-osc-postgresql). Use describe-service-instance on it to get its address and port; the connection URL is postgres://postgres:<password>@<IP>:<PORT>/postgres. Temporal uses it to persist workflow execution state, history and metadata.

Store the URL as a service secret: create-service-secret with serviceId: "temporalio-temporal", name dburl. Then call create-service-instance with serviceId: "temporalio-temporal":

{ "name": "mytemporal", "DatabaseUrl": "{{secrets.dburl}}" }

Verify with wait-for-service-ready or get-instance-status; describe-service-instance returns the instance URL, which is the Temporal Web UI.

Options

Option Required Type Meaning
name Yes string Name of the instance. Alphanumeric/underscore only (^\w+$), at most 20 characters.
DatabaseUrl Yes string, sensitive Database connection URL for Temporal's persistence layer, for example postgres://user:password@host:port/dbname. The catalog associates it with an OSC PostgreSQL instance (birme-osc-postgresql, TCP, credentials and path included). Store as a secret and pass {{secrets.NAME}}.

{{secrets.NAME}} only works as the entire field value. Overwriting a secret does not restart a running instance.

Using the instance

Install the Temporal SDK for your language and point it at the instance hostname (the hostname part of the instance URL) on port 7233.

Node.js (TypeScript/JavaScript):

import { Client, Connection } from '@temporalio/client';

const connection = await Connection.connect({
  address: '<your-instance-hostname>:7233',
});

const client = new Client({ connection });

const handle = await client.workflow.start('myWorkflow', {
  taskQueue: 'my-task-queue',
  workflowId: 'my-workflow-001',
  args: ['hello'],
});

console.log(`Workflow started: ${handle.workflowId}`);
const result = await handle.result();
console.log('Result:', result);

Python:

from temporalio.client import Client

async def main():
    client = await Client.connect("<your-instance-hostname>:7233")
    result = await client.execute_workflow(
        "MyWorkflow",
        "hello",
        id="my-workflow-001",
        task_queue="my-task-queue",
    )
    print(f"Result: {result}")

OSC CLI equivalent:

osc create birme-osc-postgresql mytemporaldb -o PostgresPassword="<password>"
osc create temporalio-temporal mytemporal \
  -o DatabaseUrl="postgres://postgres:<password>@<IP>:<PORT>/postgres"

Resources

⚠️ **GitHub.com Fallback** ⚠️