サインインブリーフィングを予約

第 2.22 章

プラグインランタイム

スコープガードやデータベースフェンスから、UNO ディスパッチ、AI(人工知能)ルートの読み取り、ライセンスチェックに至るまで、プラグインの実行基盤となる SDK(ソフトウェア開発キット)モジュールについて説明します。さらに、実際のデータベースに対するテスト、スキルの登録、およびオンボーディングについて説明します。

このページは英語の原文から AI によって翻訳されました。不明な点がある場合は、英語のページを正としてご参照ください。 このページを英語で読む

読了時間 21 分

SDK(ソフトウェア開発キット)のランタイム部分は、@adverant-nexus/plugin-sdk/runtime/*配下のモジュール群と、testing/*配下のテストヘルパーで構成されています。これらはインポートして使用するものであり、再実装するものではありません。それが基本方針であり、私がそれを真剣に受け止めるまでには、一度レビューで却下される経験が必要でした。最初のプラグインで手書きしたスコープチェックに対するレビュアーのコメントは、「SDKにはすでにこれがあり、あなたの実装はMFA(多要素認証)チャレンジトークンをセッションとして受け入れてしまっています」というわずか1行でした。

この章では、フルサービステンプレートが配線する通りに、実行中のプラグインを通過するリクエストを追跡します。具体的には、スコープガード、データベースフェンス、唯一許可された境界越え、UNOを介したディスパッチ、AI(人工知能)ルートの読み取り、およびライセンスチェックです。その後、テスト、マニフェストスキルの登録、およびオンボーディングの手順について説明します。

スコープ:フレームワークごとに1つのガード

すべての/apiルートはスコープガードを備えています。これはベアラートークンを検証し、そこから3つの軸(テナント、オーナー、ユニット)を解決し、テナントを指定するボディを拒否し、マニフェストのレジスターからルートの権限を適用して初めて、ハンドラーの実行を許可します。SDKはフレームワークごとに1つのアダプターを提供しており、すべて@adverant-nexus/plugin-sdk/runtime/scopeからインポートされ、すべて同じオプションを受け取ります。

フレームワーク アダプター
Express scopeMiddleware
Fastify requireScope、preHandlerとして
次へ ハンドラーをラップするwithScope。Nextのハンドラーにはルートが通知されないため、withScopeはそれを第3引数として受け取ります

以下は、テンプレートのExpress配線を簡略化したものです。検証機能はSDKのものであり、トークンをIDサービスのセッション形式に準拠させます。すなわち、HS256のみ、iss、exp、iat、およびjtiが必須、有効期間は最大1時間であり、MFAチャレンジ、なりすまし、またはOAuth(委任された認可のためのオープンスタンダード)リソーストークンはセッションとして認められません。

import { platformAccessTokenVerifier } from "@adverant-nexus/plugin-sdk/runtime/platform-token";
import { scopeMiddleware } from "@adverant-nexus/plugin-sdk/runtime/scope";

const requireScope = scopeMiddleware({
  verify: platformAccessTokenVerifier(config.PLATFORM_JWT_SECRET),
  rights: { manifest },
});

router.get("/api/projects", requireScope, async (req, res) => {
  res.json({ projects: await db.listProjects(scopeOf(req)) });
});

権限ガードは4つのステップでルートの権限を適用します。権限のneverリストにあるロールは、AUTHORITY_EXCEEDEDおよびbarredという文言で拒否され、いかなるシートもこれを解除できません。rolesにあるロールは許可され、権限がseat: trueを指定している場合は有効なシートも併せて必要になります。それ以外の場合は、その権限を持つ有効なシートがあれば許可されます。いずれでもない場合、リクエストはAUTHORITY_EXCEEDEDで拒否され、シートを付与できる人物の名前が示されます。ガードにストア(rights: { manifest, store: { pool, schema } })を渡すと、呼び出し元自身のスコープ下でシートを読み取ります。また、licenceを指定する権限には、後述するライセンスリーダーも必要です。

ハンドラーの内部では、解決されたスコープを読み取る唯一の方法はscopeOf(req)であり、ガードが実行されなかった場合は例外をスローします。プレフィックスに登録され、いずれかのルートが一致する前に実行されるガードは、500 MIDDLEWARE_ORDERING_ERRORを返します。また、マニフェストで宣言されていないのにコードが登録したルートは、500 UNHANDLED_ERRORを返します。どちらもフェイルクローズ(安全側への失敗)となります。

プラットフォームが呼び出すテンプレートの/internalルートは、もう一方の仕組みを使用します。サービスガードは定数時間でX-Service-Keyをチェックし、プラットフォームのX-Organization-IDからテナントを取得し、条件を満たさない場合はMISSING_SERVICE_KEY、INVALID_SERVICE_KEY、またはMISSING_ORG_ID_HEADERで拒否します。プラットフォームの署名付きコール単位トークンに対して、SDKはrequireService(Fastify)とserviceMiddleware(Express)を用意しており、これらはトークンがどのスキルとルートのために発行されたかもチェックし、2回使用されたトークンを拒否します。

データベースフェンス:tenantFenceとwithScopedTx

スコープ付きテーブルに対するすべてのステートメントは、フェンスを構成し、スコープ付きトランザクション内で実行されます。

import { withScopedTx } from "@adverant-nexus/plugin-sdk/runtime/db";
import { tenantFence } from "@adverant-nexus/plugin-sdk/runtime/fence";

async function listProjects(scope: ResolvedScope) {
  // Projects are owner-private inside the organisation, so the owner axis is passed explicitly.
  const f = tenantFence(scope, { alias: "p", owner: scope.owner });
  const r = await withScopedTx(pool, scope, { schema: SCHEMA }, (db) =>
    db.query(`SELECT p.* FROM anomaly_review.reviews p WHERE ${f.where} ORDER BY p.created_at DESC`, f.params),
  );
  return r.rows;
}

tenantFence(scope, options)は、解決されたスコープから述語とそのパラメーターを構築します。個人用テーブルの場合はownerを渡し、オーナーが来歴を表す組織のアーティファクトの場合は省略します。ステートメントにすでにパラメーターがある場合は、startIndexによってどこから番号を振るかをフェンスに指示します。インサートは決して軸を入力として受け取らず、スコープからscope.tenant、scope.owner、およびscope.unitを書き込みます。

withScopedTxは、スキーマの単一のバインド関数を通じて1つのトランザクションの3つの軸すべてをバインドし、その後コールバックを実行します。同じトランザクション内で2回目のバインドを行うと、SCOPE_ALREADY_BOUNDが発生します(500:コードが2回バインドしたためであり、呼び出し元に過失はありません)。テナントまたはオーナーが存在しないかゼロの場合は、SCOPE_PREDICATE_INVALID(403)が発生します。この設定はトランザクションローカルであるため、プールされた接続が1つのテナントを次のリクエストに持ち越すことはありません。

人のリクエストではないケースは、2つの姉妹関数がカバーします。withTenantScopedTxは、マシンが読み取る行(デバイスレジストリ)のためにオーナーなしでテナントとユニットをバインドし、オーナーを持つスコープを拒否します。maintenanceScope(reason)は、オーナートランザクションが開く前に、組織全体の操作にその旨を明示的に宣言させます。コードフェンスと強制的な行レベルセキュリティは、1つの法則に対する2つのメカニズムです。ブートチェックは、データベースが2つ目のメカニズムが有効であることを証明するまでリッスンを拒否します(証明されない場合はDB_ROLE_BYPASSES_ISOLATIONとなります)。

すべての拒否は1つの行になる

テンプレートは、ボディパーサーとルーターの間にもう1つのミドルウェア(拒否台帳)を1回だけインストールします。

import { recordRefusals } from "@adverant-nexus/plugin-sdk/runtime/refusal-ledger";

app.use(express.json({ limit: "256kb" }));
app.use(recordRefusals({ pool, schema: SCHEMA }));

これはレスポンスをラップし、権限ガード、ハンドラー、またはストアのいずれからのものであっても、人が読み取るすべての拒否が、ボディが送信される前にその人自身のスコープ付きトランザクション内でスキーマのrefusalテーブルに書き込まれるようにします。匿名の401は何も書き込みません。行を書き込めない場合、応答はUNHANDLED_ERRORになります。製品が記録できない「拒否」は、記録されたかのように送信されることはありません。ブート時にassertRefusalLedgerが実行されてテーブルが台帳の行を受け入れられるかチェックされ、ストアはすべての拒否が対象レコードを指定できるようにnoteSubject({ recordId, isDemo })を呼び出すことができます。先週の火曜日に誰かが拒否された理由を顧客から尋ねられたとき、その答えは推測ではなくクエリによって得られます。

唯一の越境:記録された読み取り専用の付与

ある顧客が別の顧客のために作業を行い、後者がそれを検査することが認められている場合、境界を越えるための公認された方法が1つあります。行を保持している組織がグラント(許可)を記録します。読み取り側の組織は、neverでownerとadminを指定する必要がある権限granted.readを持つシートを通じて人を承認します。読み取りは、databases[].grantedがリストするテーブルのみを選択できる6番目のデータベースロールである読み取りシート(read seat)として実行されます。

const r = await withSeatTx({ app: appPool, seat: seatPool }, seatsOf(req), { holder, grantId }, { schema: "anomaly_review" }, (db) => {
  const f = grantFence(db.seat, { alias: "r" });
  return db.query(`SELECT r.review_id FROM anomaly_review.reviews r WHERE ${f.where}`, f.params);
});
if (!r.ok) return res.status(r.status).json(r.refusal);

withSeatTxは、最初に読み取り側自身のテナントに閲覧記録(look)を書き込み、次に読み取りシートをグラントにバインドし、それによって保持側のテナントに閲覧記録を書き込みます。データベース自身のポリシーにより、グラントが読み取り側の組織を指定していること、テーブルをカバーしていること、開始済みであること、終了していないこと、取り下げられていないこと、およびこのトランザクションがその閲覧記録を書き込んだことがチェックされます。閲覧記録をスキップした読み取りには何も見えません。ブート時に、assertSeatAtBoot(seatPool, schema)はseat.urlから開かれたプールが本当にそのシートであり、それ以上のものではないことをチェックし、そうでない場合はDB_SEAT_ROLE_INVALIDで拒否します。

UNO を介したディスパッチ

すべての計算処理は、閉じた許可リストを持つ、1つのファイルで構築された1つのクライアントを通過します。

import { UnoClient } from "@adverant-nexus/plugin-sdk/runtime/uno";

/** The namespaced job types this surface may dispatch. Closed; edit in code. */
export const DISPATCHABLE = Object.freeze([`${manifest.name}.sentiment_score`] as const);

export function createUno(deps: UnoDeps): UnoClient {
  return new UnoClient({
    baseUrl: deps.dispatchUrl,
    serviceKey: deps.serviceKey,
    callerService: manifest.name,
    dispatchable: DISPATCHABLE,
  });
}

許可リストは意図的にモジュールレベルの定数になっています。もしオペレーターが設定からそれを広げることができれば、そのルートはレジストリ全体のディスパッチプロキシになってしまいます。テンプレート自身のテストは、リストがマニフェストのコンパイル先となるジョブタイプを正確に指定していることをアサートします。

エンベロープ

ディスパッチは、その必須コアとして6つのフィールドを持ちます。クライアントは検証されたスコープからテナントとアクターを入力し、リクエストから入力することは決してありません。

フィールド 保持する内容
jobType 名前空間付きのジョブタイプ、<plugin name>.<skill id>
organizationId スコープから取得したテナント
userId 監査と請求のための、スコープから取得したアクター
inputParams スキルの入力。テナントIDを含めることは決してなく、含まれている場合はディスパッチ時に拒否されます
priority critical、high、normal、またはlow
pluginId マニフェストのname。すべてのディスパッチはその発信元のプラグインを宣言します

オプションのフィールドには、correlationId(UUID(汎用一意識別子)、指定がない場合は新規発行されます)や、ワーカーが結果の送信先を知るためにplugin_queueスキルが必要とするcallbackUrlが含まれます。

const accepted = await uno.dispatch(scope, {
  jobType: DISPATCHABLE[0],
  inputParams: { text: text.body },
  priority: "normal",
  pluginId: manifest.name,
  correlationId: crypto.randomUUID(),
});
if (!accepted.ok) return res.status(statusFor(accepted.refusal.code)).json(accepted.refusal);
res.status(202).json(accepted.value);

202、その後ポーリング

すべてのディスパッチはキューに入れられます。応答は常に識別子(jobId、runId、traceId、status)を伴う202であり、結果そのものではありません。結果はジョブのポーリングまたはコールバックから得られます。uno.peek(jobId, { scope })はそれを1回読み取り、awaitJobは終了ステータスになるまでポーリングします。どちらも検証されたスコープからテナントを送信し、ネットワーク呼び出しの自身の側で返された行のorganization_idを呼び出し元のテナントと照合し、不一致の場合はSCOPE_REFUSEDで拒否します。

実行行(run row)はその固有の綴りで読み取ってください。ディスパッチレスポンスはjobIdと言い、行はjob_id、organization_id、およびplugin_idと言います。結果と失敗の列はresult、error、error_code、およびerror_troubleshootingです。completedとfailedは終了状態です。timed_out、cancelled、およびsystem_failureはリーパー(reaper)からのものであり、遅れて届いた結果によって後から修正される可能性があります。これらのいずれかをパース不可能として扱うクライアントは、プラットフォームが毎日書き込む行を拒否することになります。

承認保留

approvalを宣言するマニフェストスキルは、ディスパッチ時に保留されます。その際、202はstatus: "awaiting_approval"を示し、マニフェストが与えた理由とともにwaitpointIdを伴います。実行は、指名された人物が裁定を下すまで保留されたままになります。uno.approveとuno.resolveWaitpointはテナントと呼び出し元をアクターとして送信し、検証された呼び出し元以外の人物による裁定は拒否されます。承認されるとジョブは1回解放され、ディスパッチチェックが再実行されます。却下されるとfailedで終了します。2回目の裁定は拒否され、保留期限が切れた後の裁定も同様に拒否されます。製品で承認者を提案者とは別の人物にする必要がある場合は、裁定を行うルートでそれを強制してください。プラットフォームは両者を記録します。

保留中のジョブは保留中として描画してください。実行行がそう示すまでは、クリックによって解放されたとユーザーに伝えないでください。

AI:スキル行の希望条件(wishes)と1回の読み取り

プラグインがモデルを直接呼び出すことは決してありません。マニフェストスキルがモデルを必要とする場合(信頼レベルcoreまたはverifiedでのllm_onlyまたはtool_using)、そのレジストリ行で優先設定を表現すると、ルーターが組織自身のプールから決定します。

{
  "execution_config_skill": {
    "preferredProvider": "gemini",
    "capabilityProfile": { "needsToolUse": true, "dataResidency": "eu_only" }
  }
}

preferredProviderとpreferredModelは、組織がそのプロバイダーを有効にし、認証情報を設定している場合にのみルーターが尊重する希望条件です。capabilityProfileはフィルタリングを行いますが選択は決して行いません。そのdataResidency(eu_only、us_only、またはany)は、ルーターが満たすか拒否するかのいずれかとなる厳格な制約です。通常はこれらすべてを省略するのが適切です。modelOverrideは1つの正確なモデルを必要とするまれなスキルのために存在し、並記された希望条件を無効にします。他のモデルではそのスキルが意味をなさない場合を除き、使用を避けることをお勧めします。

インターフェースでルーターがどのモデルを使用するかを表示する必要がある場合は、予測するのではなく、読み取ってください。

import { createAIRouteClient } from "@adverant-nexus/plugin-sdk/runtime/ai-route";

createAIRouteClient(...).effectiveRoute()は、AI Provider Routerの唯一公認された読み取り手段です。これはゲートウェイのアドレス、呼び出し元自身のベアラー、およびプラットフォームのスラッグを受け取り、AIリクエストは送信しません。プロバイダーとモデル、ポリシーが許可するプロバイダー、および選択されたエンドポイントがlocalまたはexternalのどちらを実行するかを返します。ルートが使用できない場合は、デフォルトモデルを決して返さず、ルーターの拒否理由を言葉(改善策を伴うNO_PROVIDER_FOR_ROLE、MODEL_CAPABILITY_UNAVAILABLE、またはNO_MODEL_FOR_ROLE_AND_PROVIDER)で返します。その拒否をユーザーに表示してください。それは彼らの組織の設定が語っている内容です。

ライセンスチェック

3つのメカニズムが3つの粒度でライセンスをチェックします。

ライセンスを指定する権限。 最も単純なものです。マニフェストで権限がlicence: "<feature>"を持ち、ガードはロールが読み取られる前に、呼び出し元自身のトークンを使用して、組織のライセンスがそれを持っているかどうかをIDサービスに尋ねます。リーダーを指定してガードを構築します。

import { createLicenceReader } from "@adverant-nexus/plugin-sdk/runtime/licence";

const requireScope = scopeMiddleware({
  verify,
  rights: { manifest, store: { pool, schema: SCHEMA }, licence: createLicenceReader({ baseUrl: config.NEXUS_AUTH_URL }) },
});

その機能を持たないライセンスは、それを備えているものを示し、組織のオーナーと管理者が有効にできる旨を伝えて、全員をLICENCE_LOCKEDで拒否します。読み取ることができないライセンスはUNHANDLED_ERRORで拒否します。ライセンスに到達できなかったという理由で、ロックされた機能が提供されることは決してありません。応答は組織と機能ごとに30秒間記憶されます。

プロダクトゲート。 runtime/product-gateのcreateProductGate({ baseUrl, product })は、呼び出し元の組織が製品自体を保持しているかどうかをエンタイトルメントチェックに尋ね、そのmiddleware()はスコープガードの後に実行されます。否定的な判定はENTITLEMENT_DENIEDとなり、到達できないチェックはENTITLEMENT_UNREACHABLEとなります。ゲートが一方を他方として扱うことは決してありません。

ライセンス文書自体。 ドメインパックのクローズドモジュールなど、署名されたライセンスから自身で判断を下す必要があるコードは、runtime/licence-documentのverifyLicenceDocument(docText, opts)を使用します。これは純粋関数であり、ネットワーク呼び出しも、環境変数も、ファイルも使用しません。ビルドが保持する信頼ルートに対して両方の署名を検証し、グラント、アドオン、およびドメインパックとともに状態(VALID、WARN、GRACE、RESTRICT、TERMINATE、またはABSENT)を返します。その後、licenceAllows(verdict, featureGroup, action, tenantId?)がグループの下でuseまたはprovisionを実行してよいかどうかを示します。RESTRICTはuseを許可し、provisionにはLICENCE_LOCKEDを返すため、実行中の作業は継続され、新しい作業は一切開始されません。

テスト

テンプレートのテストはパターンを示しており、以下はその背後にあるツールです。

スコープフェイク。 解決されたスコープのテストダブルをtest/scope-fakes.tsで1回構築し、ユニットなし、トークンなし、ゼロ組織のトークンといった不在のケースを含め、あらゆる場所に注入します。拒否パスこそが製品そのものです。

フェイクディスパッチトランスポート。 UnoClientはfetch、now、およびsleepを受け取るため、ユニットテストがネットワークに触れることは決してありません。エンベロープのフィールド、202の形状、organization_idを伴う終了行へのポーリング、および別のテナントの行が破棄されることをアサートします。

実際のPostgres。 フェイクのクエリ関数はSQL文字列を証明するだけです。強制的な行レベルセキュリティが有効であることや、マイグレーターとしてファイルが順番に適用されることは証明できません。testing/ephemeral-postgresは使い捨てのサーバーを起動し、本番環境が実行するのと同じnexus-migrateを実行します。

import { EPHEMERAL_REMEDY, migrated, startEphemeralPostgres } from "@adverant-nexus/plugin-sdk/testing/ephemeral-postgres";

const pg = await startEphemeralPostgres();          // null off CI: skip each case by name with EPHEMERAL_REMEDY
const db = migrated(pg!, "plugin_test", { root });  // provision as the superuser, then every file as the migrator
// connect as db.appUrl and run the boot checks the server runs

CI(継続的インテグレーション)以外では、Postgresサーバーがないマシンは各データベースケースを名前と対処法を示してスキップし、決してグリーン(成功)にはしません。CIでは、同じ不在によってスイートが失敗(EPHEMERAL_POSTGRES_UNAVAILABLE_IN_CI)します。なぜなら、スキップされた行レベルセキュリティテストは何も測定していないグリーンゲートだからです。サーバーは起動するまで最大180秒待機し、テストプロセスが終了するとウォッチドッグがそれを停止します。

分離ハーネス。 testing/isolation-harnessのrunIsolationHarness(target)は、アプリがマウントするすべてのルートを読み取り、別の組織の管理者として、また同僚としてそれぞれを攻撃します。その後、コードフェンスを削除した状態、データベースフェンスを削除した状態、および両方を削除した状態で再度攻撃します。ルートは、いずれかのフェンスがある状態で攻撃が失敗し、両方が削除された状態で被害者のデータに到達する場合にのみPROVENとなります。これにより、テストが漏洩を確実に検知できることがわかります。各ルートの宣言されたクエリとサンプルボディを送信するため、空のリクエストを拒否するルートにも到達します。テストでledgerOf(report)を固定し、defectsOf(report)で失敗させてください。

登録:マニフェストからスキルレジストリへ

マニフェストスキルは、単一のパスでスキルレジストリに到達します。

manifest.skills[]  →  compileRegistry(manifest)  →  POST /api/v1/plugins/sync

compileRegistryは、検証されたマニフェストをnexus.plugin-sync/v1のボディに変換します。テンプレートはインポート時にこれを行うため、無効なマニフェストはビルドを失敗させます。

import { compileRegistry, definePlugin } from "@adverant-nexus/plugin-sdk";

export const manifest = definePlugin(raw);
export const registryPayload = compileRegistry(manifest);
{
  "contract": "nexus.plugin-sync/v1",
  "pluginId": "anomaly-review",
  "version": "0.3.0",
  "skills": [ { "job_type": "anomaly-review.excursion_summary", "tier": "host_callback", "classification": "tenant" } ]
}

同期は宣言的です。毎回スキルセット全体を送信し、除外されたスキルは履歴が保持されたまま無効化されます。また厳格でもあります。未知のフィールド、別のティアのフィールド、またはnullは拒否され、すべての違反は1つの400 SYNC_CONTRACT_VIOLATIONにまとめて返され、違反が1つでもある間は何も書き込まれません。そして、名前空間付きのジョブタイプをキーとし、ディスパッチャーが読み取るすべての列を備えたレジストリ行をスキルごとに1行書き込むため、同期が200を返した瞬間からスキルは実行可能になります。

プラグインが認証された呼び出し元であり、ボディフィールドがそうなることは決してありません。mTLS(相互TLS:両端に証明書を持つTransport Layer Security)を介してプラグイン自身のワークロードから同期を呼び出してください。Skills Engineはワークロードのクライアント証明書を読み取り(そのSPIFFE ID(spiffe://<trust-domain>/ns/<namespace>/sa/<service-account>)が名前空間とサービスアカウントを指定します)、その名前空間に対して記録されたプラグインと所有組織を検索します。ボディのpluginIdは一致する必要があり、これはセレクターではなくチェックです。すべての行はそのプラグインと組織で書き込まれます。

ステータス コード 意味
200 {contract, pluginId, version, created, updated, unchanged, disabled, skills}
400 SYNC_CONTRACT_VIOLATION violations[]にリストされたすべての違反。何も書き込まれません
401 UNAUTHORIZED 不正または欠落しているサービスキー
401 CALLER_IDENTITY_UNVERIFIED 読み取り可能なクライアントIDがありません
403 DELIVERY_IDENTITY_MISSING 呼び出し元の名前空間がどのプラグインにも属していません
403 PLUGIN_ID_MISMATCH ボディが別のプラグインを指定しています
409 REGISTRY_CONFLICT ジョブタイプが他の場所で所有されているか、同期の外部で登録されました。何も書き込まれません

200以外のステータスではデプロイステップを失敗させてください。他のどのステータスも、スキルが登録されたことを意味しません。

オンボーディング

オンボーディングは順序付けられた10のステップとして実行され、各ステップは単独で再実行、キャンセル、またはロールバックできます。

  1. リポジトリをクローンし、検証します。
  2. マニフェストをパースします。
  3. セキュリティ上の問題がないかスキャンします。
  4. イメージをビルドします。
  5. インストールのレジストリにプッシュします。
  6. ドメイン名を設定します。
  7. インストールのリリースチャネルを通じてデプロイします。
  8. ヘルスチェックを待機します。
  9. プラグインを登録します。
  10. 開発者に通知します。

デプロイの前に、マニフェストとビルドされたイメージに対して5つの適合性チェックが実行されます。マニフェストがパースされ必須フィールドを備えていること、宣言されたすべてのルートが実際に登録されたルートであること、プラグインが自身のスキーマを所有しその外部に何も書き込まないこと、リソースリクエストが宣言され境界内にあること、そしてイメージが機能するヘルスハンドラーを持っていることです。ブート時に自身を登録するプラグインは、自身の権限の下で同じコントラクトを実行するため、チェックはパイプラインではなく自身のCIになります。1つをスキップしてもオンボーディングは短縮されず、失敗がランタイムに先送りされるだけです。

サインインページは誰かが認証情報を持つ前にそれを必要とするため、マニフェスト内のブランディングはドメインごとに認証なしで提供されます。branding内のすべてのものは公開情報として扱ってください。

環境とプロモーション
環境とプロモーション
「環境とプロモーション」は、すべてのゲートとその状態を1つのページに表示しながら、各リリースを開発スペースからステージングを経てパイロットユニットへ、そしてすべてのユニットへと移動させます。ゲートをスキップするプロモーションはGATE_CANNOT_BE_SKIPPEDで拒否されます。
チャネルとインストール
チャネルとインストール
「チャネルとインストール」は、どのユニットがどのバージョンを実行しているかを、エラー率を(コンテンツではなく)カウントとして表示します。1つのユニットのロールバックは、そのユニットのみに影響を与えるレビュー済みの変更です。

ランタイムが代行しないこと

ランタイムは、分離、ディスパッチ、およびモデルアクセスの一線を堅守します。それが製品のロジックを正しくしてくれるわけではなく、遅いクエリを速くしてくれるわけでもありません。すべてのステートメントは、マニフェストのdbブロックが宣言するタイムアウトを伴うバインドされたトランザクション内で実行され、statementTimeoutMsを超過したステートメントは待機されるのではなくキャンセルされます。それに合わせてクエリのサイズを調整してください。また、承認保留、読み取りシート、およびライセンスリーダーはすべて、ラウンドトリップまたはトランザクションを追加します。私の異常レビュープラグインでは、30秒間のメモリがウォームアップするまで、ライセンスチェックによってリクエストごとに数ミリ秒が追加されましたが、ロックされた機能を決して提供しないための対価としては妥当なものでした。