Obter um lease e liberá-lo de novo

O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.

Carregando…

Caso de uso

A tarefa

Dois agentes não devem fazer deploy em produção ao mesmo tempo. Você dá um lease ao recurso: o primeiro agente o detém, o segundo é recusado e informado de quem o detém e de quanto tempo esperar. Um lease que nunca é liberado expira sozinho.

Pré-requisitos

Antes de começar

Plano: Qualquer plano, até o Free
Credencial: Chave API do workspace
Também precisa: Um nome de recurso que todos os agentes usam para ele

O código lê a chave de INTRAMEDIAL_KEY. Guarde-a no seu shell ou no seu cofre de segredos, nunca em um arquivo que você faz commit. Chamadas que exigem uma pessoa logada não podem usar chave: o console as faz.

Passo a passo

Passos

Obter um lease
Peça o recurso como o agente que o quer. Um recurso livre devolve um lease com validade.

Saída de exemplo

O que é devolvido

Um recurso livre responde { ok: true, lease }. O lease traz seu id, titular e validade.

JSON

200 OK

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

Evidências

O que o recibo prova

Ele prova

O plano deu a este agente um lease sobre este recurso.
Até expirar ou ser liberado, outras requisições por ele foram recusadas com lease_held.

Ele não prova isto

Continue

A seguir

Ver as tools

coordination.leasecoordination-lease

Documentação

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())

Pedir enquanto ocupado

Um segundo agente que pede o mesmo recurso é recusado com lease_held, o DID do titular e um back-off em stampede.waitMs. Todo lease dura o padrão de 30.000 ms; a rota não lê 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")

Liberar antes do prazo

Envie o recurso e o agente; release responde released e releasedIds. Um lease nunca liberado expira e um alarme o retoma.

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())

Os agentes agem quando o plano diz sim, e o registo diz porquê.

A tarefa

Antes de começar

Passos

Obter um lease

O que é devolvido

O que o recibo prova

Ele prova

Ele não prova isto

A seguir

Ver as tools

Documentação

Aviso de marcas registradas

Região

Escolha seu idioma

Pedir enquanto ocupado

Liberar antes do prazo

Receitas ligadas

Entrar na fila do slot de deploy em produção

Registrar um claim sobre um recurso

Intermediar uma role de nuvem de curta duração

Receitas por e-mail

Experimente com a chave grátis.

Obter um lease e liberá-lo de novo

Os agentes agem quando o plano diz sim, e o registo diz porquê.

A tarefa

Antes de começar

Passos

Obter um lease

O que é devolvido

O que o recibo prova

✓Ele prova

×Ele não prova isto

A seguir

Ver as tools

Documentação

Pedir enquanto ocupado

Liberar antes do prazo

Receitas ligadas

Entrar na fila do slot de deploy em produção

Registrar um claim sobre um recurso

Intermediar uma role de nuvem de curta duração

Receitas por e-mail

Experimente com a chave grátis.

Ele prova

Ele não prova isto