agents-infrastructure/alicloud-cr

Alibaba Cloud Container Registry (ACR) Skill

Manage Alibaba Cloud Container Registry Enterprise Edition instances, namespaces, repositories, images, builds, sync, security scanning, delivery chains, and Helm charts via the @alicloud/cr20181201 TypeScript SDK.

Prerequisites

Install the SDK and configure credentials before calling any API:

npm install @alicloud/cr20181201 @alicloud/openapi-core @darabonba/typescript

export ALIBABA_CLOUD_ACCESS_KEY_ID="<your-key-id>"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="<your-key-secret>"
export ALIBABA_CLOUD_REGION_ID="cn-hangzhou"

See scripts/setup_client.ts for a reusable client factory, and references/quickstart.md for full setup details including regions, error handling, and pagination.

Client Initialization

import Client from '@alicloud/cr20181201';
import { Config } from '@alicloud/openapi-core';

const client = new Client(new Config({
  accessKeyId: process.env.ALIBABA_CLOUD_ACCESS_KEY_ID,
  accessKeySecret: process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET,
  regionId: 'cn-hangzhou',
  endpoint: 'cr.cn-hangzhou.aliyuncs.com',
}));

API Overview (115 APIs in 12 Domains)

| Domain | APIs | Key Operations | Reference | |--------|------|----------------|-----------| | Instance | 16 | listInstance, getInstance, getInstanceUsage, getAuthorizationToken | references/instance.md | | Namespace | 5 | createNamespace, listNamespace, deleteNamespace | references/namespace.md | | Repository | 12 | createRepository, listRepository, getRepository, createRepoTrigger | references/repository.md | | Image Tag | 4 | createRepoTag, listRepoTag, deleteRepoTag | references/image-tag.md | | Build | 11 | createRepoBuildRule, listRepoBuildRecord, getRepoBuildRecordStatus | references/build.md | | Sync | 8 | createRepoSyncRule, createRepoSyncTask, listRepoSyncTask | references/sync.md | | Security | 11 | createRepoTagScanTask, listRepoTagScanResult, createScanRule | references/security.md | | Artifact | 19 | createArtifactBuildRule, createArtifactLifecycleRule, createArtifactSubscriptionRule | references/artifact.md | | Delivery Chain | 6 | createChain, listChain, listChainInstance | references/chain.md | | Helm Chart | 12 | createChartNamespace, createChartRepository, listChartRelease | references/chart.md | | Event Center | 4 | updateEventCenterRule, listEventCenterRecord | references/event.md | | Tag & Resource | 7 | tagResources, listTagResources, createStorageDomainRoutingRule | references/tag-resource.md |

Core Patterns

Almost All APIs Require instanceId

Get it first via listInstance:

const { body } = await client.listInstance({ pageNo: 1, pageSize: 30 });
const instanceId = body.instances?.[0]?.instanceId;

Pagination

List APIs use pageNo + pageSize. Loop until results are fewer than pageSize:

let page = 1, all: any[] = [];
while (true) {
  const { body } = await client.listRepository({ instanceId, pageNo: page, pageSize: 30 });
  all.push(...(body.repositories || []));
  if (!body.repositories || body.repositories.length < 30) break;
  page++;
}

Error Handling

try {
  await client.someApi(request);
} catch (err: any) {
  console.error(`Code: ${err.code}, Message: ${err.message}, RequestId: ${err.data?.RequestId}`);
}

Common Workflows

1. Create Repository

listInstance → createNamespace → createRepository

2. Cross-Region Sync

createRepoSyncRule → createRepoSyncTask → getRepoSyncTask (poll)

3. Security Scan

createRepoTagScanTask → getRepoTagScanStatus (poll) → listRepoTagScanResult

4. Auto-Build from Git

createRepoSourceCodeRepo → createRepoBuildRule → (push triggers build)

5. Artifact Lifecycle

createArtifactLifecycleRule → listArtifactLifecycleRule

See references/workflows.md for detailed workflow examples with full code.

API Reference Quick Index

When you need parameter details for a specific API, load the corresponding reference file:

• Instance/Auth/Endpoint: references/instance.md
• Namespace CRUD: references/namespace.md
• Repository/Trigger/SourceCode: references/repository.md
• Image Tags: references/image-tag.md
• Build Rules/Records/Logs: references/build.md
• Sync Rules/Tasks: references/sync.md
• Scan Rules/Tasks/Results: references/security.md
• Artifact Build/Lifecycle/Subscription: references/artifact.md
• Delivery Chain: references/chain.md
• Helm Chart Namespace/Repo/Release: references/chart.md
• Event Rules/Records: references/event.md
• Tags/Storage Routing: references/tag-resource.md

Each reference file contains per-API documentation with parameter tables (name, type, required, description, example).

Code Examples

See scripts/examples.ts for ready-to-use code covering:

• Instance listing and usage queries
• Namespace and repository creation
• Image tag listing and deletion
• Security scan triggering and result retrieval
• Cross-region sync rule creation
• Build rule configuration
• Helm chart repository listing