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:
bash
npm install @alicloud/cr20181201 @alicloud/openapi-core @darabonba/typescript
bash
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
typescript
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:
typescript
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:
typescript
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
typescript
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
code
listInstance → createNamespace → createRepository
2. Cross-Region Sync
code
createRepoSyncRule → createRepoSyncTask → getRepoSyncTask (poll)
3. Security Scan
code
createRepoTagScanTask → getRepoTagScanStatus (poll) → listRepoTagScanResult
4. Auto-Build from Git
code
createRepoSourceCodeRepo → createRepoBuildRule → (push triggers build)
5. Artifact Lifecycle
code
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