华为云用户手册

到期后影响 图 包年/包月 GaussDB 资源生命周期描述了包年/包月 GaussDB数据库 各个阶段的状态。购买后，在计费周期内数据库正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 图3 包年/包月GaussDB资源生命周期 到期预警 包年/包月GaussDB数据库在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云帐号的创建者。 到期后影响 当您的包年/包月GaussDB数据库到期未续费，首先会进入宽限期，资源状态变为“已过期”。宽限期内您可以正常访问数据库，但以下操作将受到限制： 变更实例规格 包年/包月转按需 退订 如果您在宽限期内仍未续费包年/包月GaussDB数据库，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的包年/包月资源执行任何操作。 保留期到期后，若包年/包月GaussDB数据库仍未续费，那么实例将被释放，数据无法恢复。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费概述。

变更配置后对计费的影响 当前包年/包月GaussDB资源的规格不满足您的业务需要时，您可以在管理制台发起变更规格操作，变更时系统将按照如下规则为您计算变更费用： 资源升配：新配置价格高于老配置价格，此时您需要支付新老配置的差价。 资源降配：新配置价格低于老配置价格，此时华为云会将新老配置的差价退给您。 资源降配会影响云数据库性能，通常不建议您这样操作。这里以资源升配且无任何优惠的场景为例，假设您在2023/04/08购买了一个包年/包月GaussDB数据库（主备版 8 vCPUs 64 GB），购买时长为1个月，计划在2023/04/18变更规格为16 vCPUs 128GB。旧配置价格为31,728 元/月，新配置价格为61,728 元/月。计算公式如下： 升配费用=新配置价格*剩余周期-旧配置价格*剩余周期 公式中的剩余周期为每个自然月的剩余天数/对应自然月的最大天数。本示例中，剩余周期=12（4月份剩余天数）/ 30（4月份最大天数）+ 8（5月份剩余天数）/ 31（5月份最大天数）=0.6581，代入公式可得升配费用=61728*0.6581-31728*0.6581=19743（元）。 更多信息请参见变更资源规格费用说明。

适用计费项 包年/包月包含以下计费项。 表1 适用计费项 计费项 说明 数据库实例 GaussDB实例对CN、DN节点进行收费，管理节点CMS、GTM不收费。 数据库存储 对数据库存储空间进行计费，包年/包月计费方式的存储空间如果超过当前容量，超出的部分将按需计费。 备份存储（可选） GaussDB提供了部分免费存储空间，用于存放您的备份数据，其总容量约为您购买存储容量的100%。 备份存储用量超过数据库存储空间的100%，超出部分将按照备份计费标准收费，计费方式为按需计费（每小时扣费一次），不足一小时按照实际使用时长收费。 公网带宽 GaussDB实例支持公网访问，公网访问会产生带宽流量费；GaussDB数据库实例在云内部网络产生的流量不计费。 假设您计划购买规格为8 vCPUs 64GB、1分片、3副本、1个协调节点，存储空间为160GB的分布式版云数据库GaussDB，购买周期为一个月。在购买数据库实例页面底部，您将看到所需费用，如图1所示。 图1 配置费用示例 备份空间费用，使用后按照统一标准计费，购买时不包含在配置费用中，可通过价格计算器查看。

适用场景 包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，如企业官网、在线商城、博客等，包年/包月计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，如科研项目、大型活动策划等，包年/包月计费模式可以确保在整个项目周期内资源的稳定使用。 业务高峰预测：如果能预测到业务高峰期，如电商促销季、节假日等，可提前购买包年/包月资源以应对高峰期的需求，避免资源紧张。 数据安全要求高：对于对数据安全性要求较高的业务，包年/包月计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。

计费示例 假设您在2023/03/08 15:50:04购买了一个包年/包月的GaussDB数据库实例（规格：分布式版 通用增强Ⅱ型 8 vCPUs 64 GB、 1分片 、 3副本、1个协调节点，160GB存储空间），计费资源包括实例规格（vCPU、内存、节点数量）、存储空间、备份空间、公网带宽。购买时长为一个月，并在到期前手动续费1个月，则： 第一个计费周期为：2023/03/08 15:50:04 ~ 2023/04/08 23:59:59 第二个计费周期为：2023/04/08 23:59:59 ~ 2023/05/08 23:59:59 2023/04/08 23:59:59~2023/05/01 23:59:59期间，使用免费备份空间60GB。 2023/05/01 23:59:59~2023/05/08 23:59:59期间，使用计费备份空间10GB，计费时长168小时。 图 包年/包月 GaussDB费用 计算示例给出了上述示例配置的费用计算过程。 图中价格仅供参考，实际计算请以云数据库GaussDB价格详情中的价格为准。 图2 包年/包月GaussDB费用计算示例

计费模式概述 云数据库GaussDB提供包年/包月、按需计费两种计费模式，以满足不同场景下的用户需求。 包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。 按需计费：一种后付费模式，即先使用再付费，按照云数据库实际使用时长计费，秒级计费，按小时结算。按需计费模式允许您根据实际业务需求灵活地调整资源使用，无需提前预置资源，从而降低预置过多或不足的风险。一般适用于电商抢购等设备需求量瞬间大幅波动的场景。 表1 计费模式 计费模式 包年/包月 按需计费 付费方式 预付费 按照订单的购买周期结算。 后付费 按照云数据库实际使用时长计费。 计费周期 按订单的购买周期计费。 秒级计费，按小时结算。 适用计费项 实例规格（vCPU和内存）、存储空间、备份空间、弹性公网IP 实例规格（vCPU和内存）、存储空间、备份空间、弹性公网IP 变更计费模式 支持变更为按需计费模式。 但包年/包月资费模式到期后，按需的资费模式才会生效。 包年/包月转按需 支持变更为包年/包月计费模式。 按需转包年/包月 变更规格 支持变更实例规格。 支持变更实例规格。 适用场景 适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。对于长期使用者，推荐该方式。 适用于计算资源需求波动的场景，可以随时开通，随时删除。 父主题： 计费模式

计费说明 云数据库GaussDB的计费项由GaussDB实例费用、存储空间费用、备份空间费用和公网带宽费用组成。具体内容如表1所示。 标 * 的计费项为必选计费项。 表1 云数据库GaussDB计费项 计费项 计费项说明 适用的计费模式 计费公式 * 数据库实例 计费因子：vCPU和内存，不同规格的实例类型提供不同的计算和存储能力。 包年/包月、按需计费 实例单个节点对应时长单价 * 购买时长 * 收费节点的数量 单个节点单价与实例规格相关，请参见云数据库GaussDB价格详情中的“GaussDB价格”。 说明： 收费节点的数量 = CN的个数 + DN的个数。 独立部署：以默认配置3分片，3副本，3个协调节点(CN)为例，1个分片，3副本有3个DN，则3个分片共有9个DN，则收费节点的数量为 3 + 9 = 12。 高可用（1主2备）：一主两备共计3个DN，则收费节点的数量为 3 。 * 存储空间 计费因子：存储类型和存储空间，按统一标准进行计费。 包年/包月、按需计费 存储空间对应时长单价 * 购买时长 * 存储容量(GB) 存储空间单价请参见云数据库GaussDB价格详情中的“存储空间价格”。 备份空间 计费因子：备份空间，按统一标准进行计费。 按需计费 备份空间单价 * 计费时长 * ( 备份容量 - 存储容量)(GB) 备份空间单价请参见云数据库GaussDB价格详情中的备份空间计费信息”。 说明： 计费时长：备份超过免费空间大小的使用时长。 公网带宽 如有互联网访问需求，您需要购买弹性公网IP。 计费因子：带宽费、流量费和IP保有费。 包年/包月计费模式支持按带宽计费方式，收取带宽费。 按需计费模式支持按带宽计费、按流量计费和加入共享带宽三种计费方式，分别收取带宽费+IP保有费、流量费+IP保有费、带宽费+IP保有费。 包年/包月、按需计费 带宽费支持使用带宽加油包抵扣，流量费支持使用共享流量包抵扣。 按固定带宽值采用阶梯计费 0Mbit/s~5Mbit/s（含）：均为一个统一的单价 大于5Mbit/s：按每Mbit/s计费 公网带宽单价请参见弹性 云服务器价格 详情中的“带宽价格”，或者弹性公网IP价格详情。

相关信息 资源记录器配置完毕后，您可以随时修改资源记录器的配置或关闭资源记录器。当前每天仅支持最多开启和修改资源记录器10次，每天0点将重置此次数。 在配置资源记录器的“资源转储”和“主题”功能时，支持选择其他账号下的OBS桶或 SMN 主题，但需先使用其他账号对当前账号进行授权，具体操作请参见跨账号授权。 在资源记录器的“授权”时，您可自行在 统一身份认证 服务（ IAM ）中创建委托，并进行“自定义授权”，授权对象为云服务Config，但必须包含可以让资源记录器正常工作的权限（调用 消息通知 服务（SMN）发送通知的权限和 对象存储服务 （OBS）的写入权限至少包含一个）。如果需要将资源变更消息和资源快照存储到“使用KMS方式加密的OBS桶”中，还需要添加KMS的密钥管理员权限（KMS Administrator），具体请参见资源变更消息和资源快照转储至OBS加密桶。创建委托详见委托其他云服务管理资源。

操作步骤 如下步骤仅针对资源记录器必须配置的参数进行介绍，其他参数保持默认即可，更多配置资源记录器的详细信息请参见配置资源记录器。 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管”下的“配置审计 Config”。 单击左侧导航栏的“资源记录器”，进入“资源记录器”页面。 打开资源记录器开关，在弹出的确认框中单击“确定”，资源记录器开启成功。 配置资源转储。 选择“您账号的桶”，然后在下拉列表中选择您账号下的OBS桶，用于存储资源变更消息及资源快照。 如您的账号下无OBS桶，则需先创建OBS桶，详见创建桶。 开启并配置消息通知（SMN）主题。 打开主题开关，选择“您自己的主题”，并选择主题所在区域和主题名，用于接收资源变更时产生的消息通知。 如您无SMN主题，则需先创建SMN主题，详见创建主题。 创建SMN主题后，还需执行“添加订阅”和“请求订阅”操作，消息通知才会生效。 进行授权，选择“快速授权”。 快速授权将为您快速创建一个名为“rms_tracker_agency”的委托权限，该权限是可以让资源记录器正常工作的权限，包含调用消息通知服务（SMN）发送通知的权限和对象存储服务（OBS）的写入权限（例如SMN Administrator和OBS OperateAccess权限）。 单击“保存”。 在弹出的确认框中单击“确定”。

操作场景 资源记录器为您提供面向资源的配置记录监控能力，帮您轻松实现海量资源的自主监管，用来跟踪您在云平台上且Config支持的云服务资源变更情况。 开启并配置资源记录器的资源转储和主题功能后，当对接服务上报Config的资源变更（被创建、修改、删除等）、资源关系变更时，您均可收到通知，同时还可对您的资源变更消息和资源快照进行定期存储。 Config服务的相关功能均依赖于资源记录器收集的资源数据，不开启资源记录器将会影响其他功能的正常使用，例如资源清单页面无法获取资源最新数据、合规规则无法创建、修改、启用和触发规则评估、资源聚合器无法聚合源账号的资源数据等，因此使用Config时您必须保持资源记录器的开启状态。 本章节指导您如何开启并配置资源记录器，用于收集您的云上资源数据，为Config的其他功能提供必须的支持。

准备工作 如果您已有一个华为账号，请忽略此步骤。如果您还没有华为账号，请参考以下步骤创建。 打开华为云官网，单击“注册”。 根据提示信息完成注册，详细操作请参见“ 注册华为账号 并开通华为云”。 注册成功后，系统会自动跳转至您的个人信息界面。 参考个人账号如何完成实名认证或企业账号如何完成实名认证，完成个人或企业账号实名认证。 为账号充值。 配置审计 服务本身为免费服务，但使用资源记录器时资源转储OBS桶和消息通知SMN主题至少需要配置一个，因此资源记录器使用的消息通知服务（SMN）或对象存储服务（OBS）可能会产生相应的费用，具体请参见SMN计费说明和OBS计费说明。 您需要确保账号有足够的余额，避免因账号余额不足或欠费导致资源记录器的相关功能无法使用，从而影响Config的其他功能也无法使用。如何充值请参见账户充值。

单击左侧的“资源合规”，进入“资源合规”页面。 基础配置完成后，单击页面右下角的“下一步”。 图1 基础配置 表1 基础配置参数说明 参数 说明 策略类型 选择“预设策略”。 预设策略即服务已开发的策略，在下方的预设策略列表中直接选择所需预设策略，快速完成规则创建。支持输入策略名称或标签进行搜索。 预设策略详见系统内置预设策略。 规则名称 规则名称默认复用所选择预设策略的名称，不能与已存在的合规规则名称重复，如有重复需自行修改。 合规规则名称仅支持数字、字母、下划线和中划线，最大长度64个字符。 规则简介 规则简介默认复用所选择预设策略的简介，也可自行修改。 目前对规则简介内容的字符类型不做限制，最大长度512个字符。 进入“规则参数”页面，规则参数配置完成后，单击“下一步”。 图2 规则参数 表2 合规规则参数说明 参数 说明 触发类型 用于触发资源合规规则。 触发类型有： 配置变更：在指定的云资源发生更改时触发规则评估。 周期执行：按照您设定的频率运行。 说明： 预设策略的触发类型不支持修改，不同预设策略支持的触发类型不同。 过滤器类型 用于指定资源类型参与规则评估。 过滤器类型分为： 指定资源：指定资源类型下的所有资源均参与规则评估。 所有资源：账号下的所有资源均参与规则评估。 仅当“触发类型”为“配置变更”时需配置此参数。 指定资源范围 过滤器类型选择“指定资源”后，需选择指定资源范围。 服务：选择资源所属的服务； 资源类型：选择对应服务下的资源类型； 区域：选择资源所在的区域。 说明： 仅当“触发类型”为“配置变更”时支持指定服务和资源类型。 当预设策略的“触发类型”为“周期执行”，且规则评估的资源类型非“account”时，支持指定资源所在的“区域”进行过滤。具体请以控制台显示为准或参见预设策略列表。 过滤范围（可选） 使用过滤范围可指定资源类型下的某个具体资源参与规则评估。 过滤范围开启后您可通过资源ID或标签指定过滤范围。 当“触发类型”为“配置变更”时，您可以根据需要选择配置此参数。 周期频率 设置合规规则周期执行的频率。 可选项：1小时、3小时、6小时、12小时、24小时。 仅当“触发类型”为“周期执行”时需配置此参数。 规则参数 此处的“规则参数”和第一步所选的“预设策略”相对应，是对第一步所选的预设策略进行具体参数设置。 例如：第一步预设策略选择“资源具有指定的标签”，指定一个标签，不具有此标签的资源，视为“不合规”，则这里的规则参数就需要指定具体的标签键和值作为判断是否合规的依据。 有的“预设策略”需要添加规则参数，有的“预设策略”不需要添加规则参数。例如：已挂载的云硬盘开启加密（volumes-encrypted-check）。 标签 单击“添加新标签”，输入标签键和标签值，为合规规则添加标签。每个合规规则最多可以添加20个标签。 标签键不能为空，可以包含任意语种的字母、数字和空格，以及_.:=+-@字符，但首尾不能包含空格，且不能以_sys_开头。长度不超过128个字符。 标签值可以为空，可以包含任意语种的字母、数字和空格，以及_.:=+-@字符，但首尾不能包含空格。长度不超过255个字符。 进入“确认规则”页面，确认规则信息无误后，单击“提交”按钮，完成合规规则添加。 图3 添加合规规则-确认规则 合规规则创建后会立即自动触发首次评估。

操作场景 本章节指导您如何通过Config的资源清单页面查看和筛选您账号下的资源，便于您了解拥有的资源及其所在区域、资源状态等信息。 资源清单中的资源数据依赖于资源记录器所收集的资源数据，如果相关资源无法在资源清单页面查询到，请确认资源记录器是否开启，或该资源类型是否被资源记录器收集资源数据，或Config暂不支持该服务或资源类型。 资源数据同步到Config存在延迟，因此资源发生变化时不会实时更新“资源清单”中的数据。对于已开启资源记录器的用户，Config会在24小时内校正资源数据。

操作步骤 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管”下的“配置审计 Config”，进入“资源清单”页面。 “资源清单”页面默认展示在资源记录器配置的监控范围内且您拥有的资源信息。 通过选择服务、资源类型和区域来筛选资源，其中全局级服务无需选择区域。 在页面中部的搜索框中通过多种筛选条件进行更精细的资源筛选。 筛选条件 说明 名称 资源名称支持模糊搜索，并且忽略大小写。 资源ID 资源ID支持模糊搜索，但不忽略大小写。 资源状态 通过资源状态对资源进行筛选。 资源状态分为以下两种： 保有中：资源正常使用中。 已删除：资源已删除。 标签 直接在搜索框列表中选择一个标签键，然后再选择此标签键相关的一个标签值或所有标签值，资源列表将自动筛选并展示此标签关联的资源。 企业项目 通过企业项目筛选框选择企业项目，资源列表将自动筛选并展示此企业项目下的资源。 说明： 根据企业项目筛选资源的功能必须要先开通企业项目才可以使用，因此该筛选条件并非对每个用户可见。

准备工作 如果您已有一个华为账号，请忽略此步骤。如果您还没有华为账号，请参考以下步骤创建。 打开华为云官网，单击“注册”。 根据提示信息完成注册，详细操作请参见“注册华为账号并开通华为云”。 注册成功后，系统会自动跳转至您的个人信息界面。 参考个人账号如何完成实名认证或企业账号如何完成实名认证，完成个人或企业账号实名认证。 为账号充值。 配置审计服务本身为免费服务，但使用资源记录器时资源转储OBS桶和消息通知SMN主题至少需要配置一个，因此资源记录器使用的消息通知服务（SMN）或对象存储服务（OBS）可能会产生相应的费用，具体请参见SMN计费说明和OBS计费说明。 您需要确保账号有足够的余额，避免因账号余额不足或欠费导致资源记录器的相关功能无法使用，从而影响Config的其他功能也无法使用。如何充值请参见账户充值。 开启并配置资源记录器。 资源清单中的资源数据依赖于资源记录器所收集的资源数据，因此必须保持资源记录器的开启状态。

功能 目前，新版成本中心提供的主要功能如下。 表1 功能参数说明 功能模块 相关文档链接 总览 总览 成本助手 成本助手 入门 入门 成本洞察 成本分析 成本分析 异常成本监控 异常成本监控 成本明细导出 成本明细导出 成本组织 成本标签 成本标签 激活成本标签 成本单元 成本单元 预算管理 预算 预算 预算报告 预算报告 成本优化 优化概览 成本优化 资源包 使用率&覆盖率分析 查看使用率分析数据 查看覆盖率分析数据 购买建议 资源包购买建议 节省计划 节省计划概览 概览 节省计划使用率&覆盖率分析 使用率&覆盖率分析 节省计划购买建议 购买建议 选项 启用共同成本分拆 开通共同成本分拆功能 启用按需转包年包月成本优化评估。 按需转包年包月建议 启用E CS 资源优化建议。 资源优化概述 启用小时粒度的成本分析。 查看成本分析 启用月粒度的多年数据。 查看成本分析

更全面的成本总览 优化“成本管理概览”的布局，将月初至今成本、月末成本预测、已超预算数/预测超预算数、近30天异常成本数、预计月度可节省成本进行信息聚合展示。 新增“当月成本分布”。支持切换汇总维度查看当月成本数据。汇总维度支持：产品类型、企业项目、成本标签、成本单元、关联账号、区域。 新增“成本助手”提供成熟度评分和洞察建议，帮助客户提升成本管理成熟度。 新增“成本分配情况”。可以切换成本分配方式查看按照不同业务视角下的成本分配情况。

Go Modules打包方式简介 本文采用Go Modules打包方式完成Go组件的构建与上传。 打包命令主要包括以下几部分： 在工作目录中创建源文件夹。 mkdir -p {module}@{version} 将代码源拷贝至源文件夹下。 cp -rf . {module}@{version} 压缩组件zip包。 zip -D -r [包名] [包根目录名称] 上传组件zip包与“go.mod”文件到私有依赖库中。 curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/{filePath} -T {{localFile}} 根据打包的版本不同，组件目录结构有以下几种情况： v2.0以下版本：目录结构与“go.mod”文件路径相同，无需附加特殊目录结构。 v2.0以上（包括v2.0）版本： “go.mod”文件中第一行以“/vX”结尾：目录结构需要包含“/vX”。例如，版本为v2.0.1，目录需要增加“v2”。 “go.mod”文件中第一行不以“/vN”结尾：目录结构不变，上传文件名需要增加“+incompatible”。 下面分别对不同的版本举例说明： v2.0以下版本打包。 以下图所示“go.mod”文件为例。 在工作目录中创建源文件夹。 命令行中，参数“module”的值为“example.com/demo”，参数“version”自定义为1.0.0。因此命令如下： mkdir -p ~/example.com/demo@v1.0.0 将代码源拷贝至源文件夹下。 参数值与上一步一致，命令行如下： cp -rf . ~/example.com/demo@v1.0.0/ 压缩组件zip包。 首先，使用以下命令，进入组件zip包所在根目录的上层目录。 cd ~ 然后，使用zip命令将代码压缩成组件包。命令行中，“包根目录名称”为“example.com”“包名”自定义为“v1.0.0.zip”，因此命令如下： zip -D -r v1.0.0.zip example.com/ 上传组件zip包与“go.mod”文件到私有依赖库中。 命令行中，参数“username”、“password”、“repoUrl”均可通过私有依赖库配置文件获取。 对于zip包，参数“filePath”为“example.com/demo/@v/v1.0.0.zip”，“localFile”为“v1.0.0.zip”。 对于“go.mod”文件，参数“filePath”为“example.com/demo/@v/v1.0.0.mod”，“localFile”为“example.com/demo@v1.0.0/go.mod”。 因此命令如下（参数username、password、repoUrl请参照私有依赖库配置文件自行修改）： curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/@v/v1.0.0.zip -T v1.0.0.zip curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/@v/v1.0.0.mod -T example.com/demo@v1.0.0/go.mod v2.0以上版本打包，且“go.mod”文件中第一行以“/vX”结尾。 以下图所示“go.mod”文件为例。 在工作目录中创建源文件夹。 命令行中，参数“module”的值为“example.com/demo/v2”，参数“version”自定义为“2.0.0”。因此命令如下： mkdir -p ~/example.com/demo/v2@v2.0.0 将代码源拷贝至源文件夹下。 参数值与上一步一致，命令行如下： cp -rf . ~/example.com/demo/v2@v2.0.0/ 压缩组件zip包。 首先，使用以下命令，进入组件zip包所在根目录的上层目录。 cd ~ 然后，使用zip命令将代码压缩成组件包。命令行中，“包根目录名称”为“example.com”“包名”自定义为“v2.0.0.zip”，因此命令如下： zip -D -r v2.0.0.zip example.com/ 上传组件zip包与“go.mod”文件到私有依赖库中。 命令行中，参数“username”、“password”、“repoUrl”均可通过私有依赖库配置文件获取。 对于zip包，参数“filePath”为“example.com/demo/v2/@v/v2.0.0.zip”，“localFile”为“v2.0.0.zip”。 对于“go.mod”文件，参数“filePath”为“example.com/demo/v2/@v/v2.0.0.mod”，“localFile”为“example.com/demo/v2@v2.0.0/go.mod”。 因此命令如下（参数username、password、repoUrl请参照私有依赖库配置文件自行修改）： curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/v2/@v/v2.0.0.zip -T v2.0.0.zip curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/v2/@v/v2.0.0.mod -T example.com/demo/v2@v2.0.0/go.mod v2.0以上版本打包，且“go.mod”文件中第一行不以“/vX”结尾。 以下图所示“go.mod”文件为例。 在工作目录中创建源文件夹。 命令行中，参数“module”的值为“example.com/demo”，参数“version”自定义为“3.0.0”。因此命令如下： mkdir -p ~/example.com/demo@v3.0.0+incompatible 将代码源拷贝至源文件夹下。 参数值与上一步一致，命令行如下： cp -rf . ~/example.com/demo@v3.0.0+incompatible/ 压缩组件zip包。 首先，使用以下命令，进入组件zip包所在根目录的上层目录。 cd ~ 然后，使用zip命令将代码压缩成组件包。命令行中，“包根目录名称”为“example.com”“包名”自定义为“v3.0.0.zip”，因此命令如下： zip -D -r v3.0.0.zip example.com/ 上传组件zip包与“go.mod”文件到私有依赖库中。 命令行中，参数“username”、“password”、“repoUrl”均可通过私有依赖库配置文件获取。 对于zip包，参数“filePath”为“example.com/demo/@v/v3.0.0+incompatible.zip”，“localFile”为“v3.0.0.zip”。 对于“go.mod”文件，参数“filePath”为“example.com/demo/@v/v3.0.0+incompatible.mod”，“localFile”为“example.com/demo@v3.0.0+incompatible/go.mod”。 因此命令如下（参数username、password、repoUrl请参照私有依赖库配置文件自行修改）： curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/@v/v3.0.0+incompatible.zip -T v3.0.0.zip curl -u {{username}}:{{password}} -X PUT {{repoUrl}}/example.com/demo/@v/v3.0.0+incompatible.mod -T example.com/demo@v3.0.0+incompatible/go.mod

发布私有组件到Go私有依赖库 下载私有依赖库配置文件。 登录制品仓库，选择私有依赖库，进入Go私有依赖库。单击页面右侧“操作指导”。 在弹框中单击“下载配置指导文件”。 配置代码仓库。 进入 代码托管服务 。创建Go语言代码仓库（操作步骤请参考创建云端仓库）。本文中使用仓库模板“Go Web Demo”创建代码仓库。 准备“go.mod”文件，并上传至代码仓库的根目录中。本文中使用的“go.mod”文件如下所示： 配置并执行编译构建任务。 在代码仓库中，单击页面右上角“设置构建”，页面跳转至“新建编译构建任务”页面。 在页面中选择“空白构建模板”，单击“下一步”。 添加步骤“Go语言构建”。 编辑步骤“Go语言构建”。 工具版本按照实际选择，本文中选择“go-1.13.1”。 删除已有命令行，打开在步骤1中下载的配置文件，将文件中的“LINUX下配置go环境变量命令”复制到命令框中。 将配置文件中go上传命令代码段复制到命令框中，并参考Go Modules打包方式简介替换命令行中的参数信息（本文打包版本为“v1.0.0”）。 单击“新建并执行”，执行构建任务。 待页面提示“构建成功”时，进入私有依赖库，可找到通过构建任务上传的Go私有组件。

发布私有组件到NPM私有依赖库 下载私有依赖库配置文件。 登录制品仓库，选择私有依赖库，进入NPM私有依赖库。单击页面右侧“设置仓库”，记录仓库的路径。 单击“取消”返回私有依赖库页面，单击页面右侧“操作指导”。 在弹框中单击“下载配置文件”。 在本地将下载的“npmrc”文件另存为“.npmrc”文件。 配置代码仓库。 进入代码托管服务，创建Node.js代码仓库（操作步骤请参考创建云端仓库）。本文使用模板“nodejs Webpack Demo”创建代码仓库。 进入代码仓库，将“.npmrc”文件上传至代码仓库的根目录中。 在代码仓库中找到“package.json”文件并打开，将在“编辑私有依赖库”页面中记录的路径信息添加到name字段对应的值中。 实际操作中，若出现name字段的值固定且不便修改的情况，则可以在“编辑私有依赖库”页面将该值配置到“添加路径”字段中。 配置并执行编译构建任务。 在代码仓库中，单击页面右上角“设置构建”，页面跳转至“新建编译构建任务”页面。 在页面中选择“空白构建模板”，单击“下一步”。 添加步骤“Npm构建”。 编辑步骤“Npm构建”。 工具版本按照实际选择，本文中选择“nodejs12.7.0”。 删除已有命令行，输入以下命令： export PATH=$PATH:/root/.npm-global/bin npm config set strict-ssl false npm publish 单击“新建并执行”，启动构建任务执行。 待任务执行成功时，进入私有依赖库，可找到通过构建任务上传的Npm私有组件。

从NPM私有依赖库获取依赖包 以发布私有组件到NPM私有依赖库中发布的Npm私有组件为例，介绍如何从Npm私有依赖库中获取依赖包。 配置代码仓库。 进入代码托管服务，创建Node.js代码仓库（操作步骤请参考创建云端仓库）。本文使用模板“nodejs Webpack Demo”创建代码仓库。 参考发布私有组件到NPM私有依赖库，获取“.npmrc”文件并上传至需要使用Npm依赖包的代码仓库根目录中。 在代码仓库中找到“package.json”文件并打开，将依赖包配置到dependencies字段中，本文中配置的值为： "@test/vue-demo": "^1.0.0" 配置并执行编译构建任务。 在代码仓库中，单击页面右上角“设置构建”，页面跳转至“新建编译构建任务”页面。 在页面中选择“空白构建模板”，单击“下一步”。 添加步骤“Npm构建”。 编辑步骤“Npm构建”。 工具版本按照实际选择，本文中选择“nodejs12.7.0”。 删除已有命令行，输入以下命令： export PATH=$PATH:/root/.npm-global/bin npm config set strict-ssl false npm install --verbose 单击“新建并执行”，启动构建任务执行。 待任务执行成功时，查看构建任务详情，在日志中找到类似如下内容，说明编译构建任务从私有依赖库完成了依赖包下载并构建成功。

NPM命令简介 在编译构建任务命令行中，还可以配置如下Npm命令，以完成其它功能： 删除私有依赖库中已存在的私有组件 npm unpublish @socpe/packageName@version 获取标签列表 npm dist-tag list @scope/packageName 新增标签 npm dist-tag add @scope/packageName@version tagName --registry registryUrl --verbose 删除标签 npm dist-tag rm @scope/packageName@version tagName --registry registryUrl --verbose 命令行参数说明： scope：私有依赖库路径，查看方法请参考发布私有组件到NPM私有依赖库。 packageName：“package.json”文件中，name字段中scope之后的部分。 version：“package.json”文件中，version字段对应的值。 registryUrl：私有库配置文件中的对应scope的私有库地址url。 tagName：标签名称。 以发布私有组件到NPM私有依赖库发布的私有组件为例： scope对应的值为“test”。 packageName对应的值为“vue-demo”。 version对应的值为“1.0.0”。 因此，删除此组件的命令应为： npm unpublish @test/vue-demo@1.0.0

背景信息 NPM（Node Package Manager）是一个JavaScript包管理工具，NPM组件包即NPM管理的对象，而NPM私有依赖库就是管理和存储NPM组件包的一个私有仓库。 私有依赖库管理各种开发语言对应的私有组件包（开发者通俗称之为私服）。由于不同的开发语言组件通常有不同的归档格式要求，私有依赖库目的就在于管理私有开发语言组件并在企业或团队内共享给其他开发者开发使用。 本文档介绍如何通过编译构建任务发布私有组件到Npm私有依赖库、如何从Npm私有依赖库获取依赖包完成编译构建任务。

步骤一：获取私有依赖库地址与配置 获取私有依赖库地址。 进入私有依赖库，选择“仓库视图”，并在左侧边栏中选择目标Maven私有依赖库。 单击仓库名称，右侧页面中仓库的“概览”页签中详细信息显示“仓库地址”。单击即可复制仓库地址。 图2 获取私有依赖库地址 获取私有依赖库配置。 单击页面右上方“操作指导”。 在“操作指导”对话框中单击“下载配置文件”，下载配置文件settings.xml至本地。 图3 下载配置文件 在本地打开配置文件settings.xml，在文件中搜索并找到如下红框中的用户名与密码。

步骤二：配置迁移工具 返回私有依赖库，单击页面右侧并在下拉列表选择“下载迁移工具”。 图4 下载迁移工具 将迁移工具MigrateTool.rar包下载到本地，并执行以下命令，将MigrateTool.rar包解压并进入解压后的目录中。 unrar x MigrateTool.rar cd MigrateTool/ 用记事本打开MigrateTool.rar包解压后目录中的application.yaml文件，配置表1所示参数。 表1 配置迁移工具参数 参数名称 参数说明 package_type JFrog源仓库类型，配置为“maven”。 repo_type JFrog源仓库类型，配置为“jfrog”。 domain JFrog源仓库地址，例如“http://本地JFrog仓库IP:本地JFrog仓库端口/artifactory”。 repo 需要迁移的JFrog源仓库名称，根据实际名称填写。 user_name 登录JFrog源仓库的账号，根据实际情况填写。 password 登录JFrog源仓库的密码，根据实际情况填写。 target_repo_type 迁移后的目标仓库类型，配置为“artifactory”。 target_domain 迁移后的目标仓库地址，配置为图5中“/artgalaxy/”前半段的的信息。 target_repo 迁移后的目标仓库ID，配置为图5中“/artgalaxy/”后半段的的信息。 target_user_name 迁移后的目标仓库账号，配置为从2.c中获取的username。 target_password 迁移后的目标仓库密码，配置为从2.c中获取的password。 图5 迁移后的目标仓库详细信息

在Maven私有依赖库的版本视图中查看归档的组件 进入目标私有依赖库，找到通过构建任务上传的Maven私有组件。 参考上述步骤，在代码仓库中设置组件版本，可将多个版本组件归档至私有依赖库。 单击“版本视图”。 在包列表中，可以查看从编译构建中获取软件包的版本数和最新版本。 单击“包名”，页面将显示该软件包最新版本的概览信息。 选择“文件列表”页签，在列表中可以单击目标组件操作列中的，可将组件下载到本地。 用户在本地对组件修改并设置新的版本号后，在目标私有依赖库中，单击“上传组件”，可将最新版本的组件上传至私有依赖库。 版本视图中的包列表显示对应组件最新上传的版本并统计版本归档过的数量。

通过编译构建发布Maven私有组件到私有依赖库 在代码仓库完成设置组件版本后，单击页面右上角“设置构建”，页面跳转至“新建编译构建任务”页面。 在页面中选择“空白构建模板”，单击“下一步”。 单击“点击添加构建步骤”。搜索并添加步骤“Maven构建”。 编辑步骤“Maven构建”。 工具版本按照实际选择，本文中选择“maven3.5.3-jdk8-open”。 找到以下命令行，删除命令行前的#。 #mvn deploy -Dmaven.test.skip=true -U -e -X -B 找到以下命令行，在命令行前添加#。 mvn package -Dmaven.test.skip=true -U -e -X -B 在“发布依赖包到CodeArts私有依赖库”一栏勾选“配置所有pom”，并在下拉列表中选择与已项目关联的Maven私有依赖库。 单击“新建并执行”，执行构建任务。

背景信息 相对于开发过程中的“源代码”，制品仓库服务关注和管理开发产生的待部署的软件包。软件包通常是由源码编译构建或打包而成，其中涉及生命周期的元数据（如名称、大小等基本属性、代码库地址、代码分支信息、构建任务、构建者、构建时间）。在开发过程中，软件包会根据不同版本不断生成改进。 软件包及其属性的管理是发布过程管理的基础，也是软件开发过程中的重要资产，而能够及时查看软件包的版本记录也成为开发者面临的诉求。

发布私有组件到RPM私有依赖库 登录制品仓库，选择私有依赖库，进入RPM私有依赖库。单击页面右侧“操作指导”。 在弹框中单击“下载配置文件”。 在Linux主机中执行以下命令，上传RPM组件。 curl -u {{user}}:{{password}} -X PUT https://{{repoUrl}}/{{component}}/{{version}}/ -T {{localFile}} 其中，“user”、“password”、“repoUrl”来源于上一步下载的配置文件中“rpm上传命令”部分。 user：位于curl -u与-X之间、“:”之前的字符串。 password：位于curl -u与-X之间、“:”之后的字符串。 repoUrl：“https://”与“/{{component}}”之间的字符串。 “component”、“version”、“localFile”来源于待上传的Rpm组件。以组件“hello-0.17.2-54.x86_64.rpm”为例。 component：软件名称，即“hello”。 version：软件版本，即“0.17.2”。 localFile：Rpm组件，即“hello-0.17.2-54.x86_64.rpm”。 完整的命令行如下图所示： 命令执行成功，进入私有依赖库，可找到已上传的RPM私有组件。

从Rpm私有依赖库获取依赖包 以发布私有组件到RPM私有依赖库中发布的Rpm私有组件为例，介绍如何从Rpm私有依赖库中获取依赖包。 参考发布私有组件到RPM私有依赖库，下载Rpm私有依赖库配置文件。 打开配置文件，将文件中所有“{{component}}”替换为上传Rpm文件时使用的“{{component}}”值（本文档中该值为“hello”），并删除“rpm上传命令”部分，保存文件。 将修改后的配置文件保存到Linux主机的“/etc/yum.repos.d/”目录中。 执行以下命令，下载Rpm组件。其中，hello为组件的“component”值，请根据实际情况修改。 yum install hello