Robertjam954/multimodal_rag_application / .claude/skills/azure-prepare
azure-prepare
FlaggedPrepare Azure apps for deployment (infra Bicep/Terraform, azure.yaml, Dockerfiles). Use for create/modernize or create+deploy; not cross-cloud migration (use azure-cloud-migrate). DO NOT USE FOR: copilot-sdk apps (use azure-hosted-copilot-sdk), or Python code-only App Service deploys (use python-appservice-deploy). WHEN: "create app", "build web app", "create API", "modernize application", "host on Azure", "deploy to Azure", "deploy to Azure using Terraform", "deploy to Azure App Service", "deploy to Azure App Service using Terraform", "deploy to Azure Container Apps", "generate Terraform", "generate Bicep", "function app", "timer trigger", "service bus trigger", "event-driven function", "managed identity".
references/services/durable-task-scheduler/javascript.md
View on GitHub# Durable Task Scheduler — JavaScript
## Learn More
- [Durable Task Scheduler documentation](https://learn.microsoft.com/azure/durable-task-scheduler/)
- [Durable Functions JavaScript guide](https://learn.microsoft.com/azure/azure-functions/durable/durable-functions-overview?tabs=javascript)
## Durable Functions Setup
### Required npm Packages
```json
{
"dependencies": {
"@azure/functions": "^4.0.0",
"durable-functions": "^3.0.0"
}
}
```
> **💡 Finding latest versions**: Run `npm view durable-functions version` or check [npmjs.com/package/durable-functions](https://www.npmjs.com/package/durable-functions) for the latest stable release.
### host.json
```json
{
"version": "2.0",
"extensions": {
"durableTask": {
"hubName": "default",
"storageProvider": {
"type": "durabletask-scheduler",
"connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
}
}
},
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.*, 5.0.0)"
}
}
```
### local.settings.json
```json
{
"IsEncrypted": false,
"Values": {
"FUNCTIONS_WORKER_RUNTIME": "node",
"AzureWebJobsStorage": "UseDevelopmentStorage=true",
"DURABLE_TASK_SCHEDULER_CONNECTION_STRING": "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None"
}
}
```
## Minimal Example
```javascript
const { app } = require("@azure/functions");
const df = require("durable-functions");
// Activity
df.app.activity("sayHello", {
handler: (city) => `Hello ${city}!`,
});
// Orchestrator
df.app.orchestration("myOrchestration", function* (context) {
const result1 = yield context.df.callActivity("sayHello", "Tokyo");
const result2 = yield context.df.callActivity("sayHello", "Seattle");
return `${result1}, ${result2}`;
});
// HTTP Starter
app.http("HttpStart", {
route: "orchestrators/{orchestrationName}",
methods: ["POST"],
authLevel: "function",
extraInputs: [df.input.durableClient()],
handler: async (request, context) => {
const client = df.getClient(context);
const instanceId = await client.startNew(request.params.orchestrationName);
return client.createCheckStatusResponse(request, instanceId);
},
});
```
## Workflow Patterns
### Fan-Out/Fan-In
```javascript
df.app.orchestration("fanOutFanIn", function* (context) {
const cities = ["Tokyo", "Seattle", "London", "Paris", "Berlin"];
// Fan-out: schedule all activities in parallel
const tasks = cities.map((city) => context.df.callActivity("sayHello", city));
// Fan-in: wait for all to complete
const results = yield context.df.Task.all(tasks);
return results;
});
```
### Human Interaction
```javascript
df.app.orchestration("approvalWorkflow", function* (context) {
yield context.df.callActivity("sendApprovalRequest", context.df.getInput());
// Wait for approval event with timeout
const expiration = new Date(context.df.currentUtcDateTime);
expiration.setDate(expiration.getDate() + 3);
const approvalTask = context.df.waitForExternalEvent("ApprovalEvent");
const timeoutTask = context.df.createTimer(expiration);
const winner = yield context.df.Task.any([approvalTask, timeoutTask]);
if (winner === approvalTask) {
return approvalTask.result ? "Approved" : "Rejected";
}
return "Timed out";
});
```
## Orchestration Determinism
| ❌ NEVER | ✅ ALWAYS USE |
|----------|--------------|
| `new Date()` | `context.df.currentUtcDateTime` |
| `Math.random()` | Pass random values from activities |
| `setTimeout()` | `context.df.createTimer()` |
| Direct I/O, HTTP, database | `context.df.callActivity()` |
### Replay-Safe Logging
```javascript
df.app.orchestration("myOrchestration", function* (context) {
if (!context.df.isReplaying) {
console.log("Started"); // Only logs once, not on replay
}
const result = yield context.df.callActivity("myActivity", "input");
return result;
});
```
## Error Handling & Retry
```javascript
df.app.orchestration("workflowWithRetry", function* (context) {
const retryOptions = new df.RetryOptions(5000, 3); // firstRetryInterval, maxAttempts
retryOptions.backoffCoefficient = 2.0;
retryOptions.maxRetryIntervalInMilliseconds = 60000;
try {
const result = yield context.df.callActivityWithRetry(
"unreliableService",
retryOptions,
context.df.getInput()
);
return result;
} catch (ex) {
context.df.setCustomStatus({ error: ex.message });
yield context.df.callActivity("compensationActivity", context.df.getInput());
return "Compensated";
}
});
```
## Durable Task SDK (Non-Functions)
For applications running outside Azure Functions (containers, VMs, Azure Container Apps, Azure Kubernetes Service):
```javascript
const { createAzureManagedWorkerBuilder, createAzureManagedClient } = require("@microsoft/durabletask-js-azuremanaged");
const connectionString = "Endpoint=http://localhost:8080;Authentication=None;TaskHub=default";
// Activity
const sayHello = async (_ctx, name) => `Hello ${name}!`;
// Orchestrator
const myOrchestration = async function* (ctx, name) {
const result = yield ctx.callActivity(sayHello, name);
return result;
};
async function main() {
// Worker
const worker = createAzureManagedWorkerBuilder(connectionString)
.addOrchestrator(myOrchestration)
.addActivity(sayHello)
.build();
await worker.start();
// Client
const client = createAzureManagedClient(connectionString);
const instanceId = await client.scheduleNewOrchestration("myOrchestration", "World");
const state = await client.waitForOrchestrationCompletion(instanceId, true, 30);
console.log("Output:", state.serializedOutput);
await client.stop();
await worker.stop();
}
main().catch(console.error);
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |