Prendre un lease puis le libérer

Intramedial est en bêta restreinte. À l’inscription ou à la connexion, vous devez fournir le mot de passe de bêta-testeur que vous avez reçu ou en demander un à preview@intramedial.com. Merci.

Chargement…

Cas d'usage

La tâche

Deux agents ne doivent pas déployer en production en même temps. Vous donnez un lease à la ressource : le premier agent le détient, le second est refusé et informé de qui le détient et de combien de temps attendre. Un lease jamais libéré expire de lui-même.

Les prérequis

Avant de commencer

Forfait: Tout forfait, Free compris
Identifiant: Clé API de workspace
Requis aussi: Un nom de ressource que tous les agents utilisent pour elle

Le code lit la clé depuis INTRAMEDIAL_KEY. Gardez-la dans votre shell ou votre coffre à secrets, jamais dans un fichier que vous commitez. Les appels qui exigent une personne connectée ne peuvent pas utiliser de clé : c’est la console qui les fait.

Pas à pas

Étapes

Prendre un lease
Demandez la ressource en tant qu’agent qui la veut. Une ressource libre renvoie un lease avec une expiration.

Sortie type

Ce qui revient

Une ressource libre répond { ok: true, lease }. Le lease porte son identifiant, son détenteur et son expiration.

JSON

200 OK

{
  "ok": true,
  "lease": {
    "id": "lease_4c1e",
    "resource": "lock:deploy/production",
    "holder": "did:web:acme.example:agent:release",
    "expiresAtMs": ,
    : { : , : [] },
    : ,
    : {}
  }
}

Preuves

Ce que prouve le reçu

Il prouve

Le plan a donné à cet agent un lease sur cette ressource.
Jusqu’à son expiration ou sa libération, les autres demandes ont été refusées avec lease_held.

Il ne prouve pas

Et ensuite

Pages outils

coordination.leasecoordination-lease

Documentation

curl -sS -X POST https://api.intramedial.com/api/v1/acp/coordination/lease \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "resource": "lock:deploy/production",
  "actorDid": "did:web:acme.example:agent:release"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/coordination/lease", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    resource: "lock:deploy/production",
    actorDid: "did:web:acme.example:agent:release",
  }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/coordination/lease",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "resource": "lock:deploy/production",
        "actorDid": "did:web:acme.example:agent:release",
    },
    timeout=30,
)
print(res.status_code, res.json())

Demander pendant qu’elle est détenue

Un second agent qui demande la même ressource est refusé avec lease_held, le DID du détenteur et une temporisation dans stampede.waitMs. Chaque lease dure 30 000 ms par défaut ; la route ne lit pas ttlMs.

curl -sS -X POST https://api.intramedial.com/api/v1/acp/coordination/lease \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "resource": "lock:deploy/production",
  "actorDid": "did:web:acme.example:agent:cost"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/coordination/lease", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    resource: "lock:deploy/production",
    actorDid: "did:web:acme.example:agent:cost",
  }),
});
const body = await res.json();
if (!body.ok) console.log(body.reason, "held by", body.holder, "wait", body.stampede?.waitMs, "ms");

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/coordination/lease",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "resource": "lock:deploy/production",
        "actorDid": "did:web:acme.example:agent:cost",
    },
    timeout=30,
)
body = res.json()
if not body.get("ok"):
    print(body["reason"], "held by", body["holder"], "wait", body["stampede"]["waitMs"], "ms")

Le libérer plus tôt

Envoyez la ressource et l’agent ; release répond released et releasedIds. Un lease jamais libéré expire et une alarme le reprend.

curl -sS -X POST https://api.intramedial.com/api/v1/acp/coordination/release \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "resource": "lock:deploy/production",
  "actorDid": "did:web:acme.example:agent:release"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/coordination/release", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    resource: "lock:deploy/production",
    actorDid: "did:web:acme.example:agent:release",
  }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/coordination/release",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "resource": "lock:deploy/production",
        "actorDid": "did:web:acme.example:agent:release",
    },
    timeout=30,
)
print(res.status_code, res.json())

Les agents agissent quand le plan dit oui, et le registre dit pourquoi.

La tâche

Avant de commencer

Étapes

Prendre un lease

Ce qui revient

Ce que prouve le reçu

Il prouve

Il ne prouve pas

Et ensuite

Pages outils

Documentation

Avis sur les marques

Région

Choisissez votre langue

Demander pendant qu’elle est détenue

Le libérer plus tôt

Recettes liées

Faire la queue pour le créneau de déploiement en production

Déposer une revendication sur une ressource

Courtier d’un rôle cloud de courte durée

Les recettes par e-mail

Essayez avec la clé de test.

Prendre un lease puis le libérer

Les agents agissent quand le plan dit oui, et le registre dit pourquoi.

La tâche

Avant de commencer

Étapes

Prendre un lease

Ce qui revient

Ce que prouve le reçu

✓Il prouve

×Il ne prouve pas

Et ensuite

Pages outils

Documentation

Demander pendant qu’elle est détenue

Le libérer plus tôt

Recettes liées

Faire la queue pour le créneau de déploiement en production

Déposer une revendication sur une ressource

Courtier d’un rôle cloud de courte durée

Les recettes par e-mail

Essayez avec la clé de test.

Il prouve

Il ne prouve pas