如何利用AWS Codeartifact代理npm私有与公共包实现团队包安装

一、确认CodeArtifact仓库配置有效性 #

你已经创建了仓库和上游，现在需要做2个关键校验：

• 检查私有仓库是否已关联AWS官方的npm-store上游源（这是CodeArtifact默认的公网npm代理源，用于拉取react-hook-form、axios等公共包）
• 给团队成员的IAM账号分配codeartifact:ReadFromRepository、codeartifact:GetAuthorizationToken、codeartifact:DescribeRepository这几个核心权限，确保他们能访问仓库并获取授权令牌

二、打包并发布私有Radix-UI组件包 #

1. 配置组件包的package.json：
   • 命名采用私有包规范（比如@your-team/ui-radix-components）
   • 正常声明react、react-hook-form等依赖到dependencies字段，无需特殊处理
   • 添加publishConfig指定CodeArtifact仓库地址：

     "publishConfig": {
       "registry": "https://your-domain-123456789012.d.codeartifact.cn-north-1.amazonaws.com/npm/your-private-repo/"
     }
     

2. 本地配置npm并发布：
   • 先获取临时授权令牌并登录CodeArtifact：

     aws codeartifact get-authorization-token --domain your-domain --domain-owner 123456789012 --region cn-north-1 --query authorizationToken --output text | npm login --registry=https://your-domain-123456789012.d.codeartifact.cn-north-1.amazonaws.com/npm/your-private-repo/ --username aws --password-stdin
     

   • 执行发布命令：

     npm publish
     

三、统一团队成员的npm环境配置 #

让成员将npm默认 registry 指向你的CodeArtifact仓库，这样npm install时会自动从CodeArtifact拉取私有包和代理的公共包：

1. 全局配置方案（适合长期使用）：

   # 登录CodeArtifact
   aws codeartifact get-authorization-token --domain your-domain --domain-owner 123456789012 --region cn-north-1 --query authorizationToken --output text | npm login --registry=https://your-domain-123456789012.d.codeartifact.cn-north-1.amazonaws.com/npm/your-private-repo/ --username aws --password-stdin
   # 设置全局registry
   npm config set registry https://your-domain-123456789012.d.codeartifact.cn-north-1.amazonaws.com/npm/your-private-repo/
   

2. 项目级配置方案（推荐，避免全局污染）：
   在项目根目录创建.npmrc文件，内容如下：

   registry=https://your-domain-123456789012.d.codeartifact.cn-north-1.amazonaws.com/npm/your-private-repo/
   //your-domain-123456789012.d.codeartifact.cn-north-1.amazonaws.com/npm/your-private-repo/:username=aws
   //your-domain-123456789012.d.codeartifact.cn-north-1.amazonaws.com/npm/your-private-repo/:_authToken=${CODEARTIFACT_AUTH_TOKEN}
   

   成员每次安装前执行以下命令获取临时令牌：

   export CODEARTIFACT_AUTH_TOKEN=$(aws codeartifact get-authorization-token --domain your-domain --domain-owner 123456789012 --region cn-north-1 --query authorizationToken --output text)
   

四、实现类似create-react-app的一键安装体验 #

可以编写一个简单的初始化脚本，让成员一键完成项目创建、配置、依赖安装：

#!/bin/bash
# 初始化Next.js项目（可根据团队技术栈调整）
npx create-next-app@latest my-radix-project --typescript --tailwind --eslint
cd my-radix-project

# 写入.npmrc配置
cat > .npmrc << EOF
registry=https://your-domain-123456789012.d.codeartifact.cn-north-1.amazonaws.com/npm/your-private-repo/
//your-domain-123456789012.d.codeartifact.cn-north-1.amazonaws.com/npm/your-private-repo/:username=aws
//your-domain-123456789012.d.codeartifact.cn-north-1.amazonaws.com/npm/your-private-repo/:_authToken=\${CODEARTIFACT_AUTH_TOKEN}
EOF

# 获取令牌并安装私有组件
export CODEARTIFACT_AUTH_TOKEN=$(aws codeartifact get-authorization-token --domain your-domain --domain-owner 123456789012 --region cn-north-1 --query authorizationToken --output text)
npm install @your-team/ui-radix-components

把脚本共享给团队，执行后就能直接得到配置完成的项目，且所有依赖（私有组件+公共包）都从CodeArtifact拉取。

五、验证流程 #

• 成员执行npm install @your-team/ui-radix-components后，查看package-lock.json，确认所有依赖的resolved字段都指向CodeArtifact地址
• 检查内网流量日志，确认没有访问公网npm的请求

内容的提问来源于stack exchange，提问作者Hojoong Kim