集成自定义更改与重建#

Tokkio 使用 UCS Tools 来构建和部署其微服务,使用 UCS Tools

先决条件#

  1. 下载并安装 UCS 工具

  2. 确保同步 UCS 工具的 repo,如上述文档指示。

  3. 确保授予从 UCS 仓库拉取的必要权限。

  4. 确保为您的团队创建了 NGC 注册表,您可以在其中上传自定义资源或 chart。

按照以下步骤构建 Tokkio 工作流程的自定义版本

  1. tokkio-app.yaml 中引用新更新的微服务版本(如果适用),并在必要时更新 tokkio-app-params.yaml 文件。

  2. 使用 UCS app builder 构建应用程序以创建 helm chart

    $ ucf_app_builder_cli app build <app-spec-yaml> <param-yaml>
    # <param-yaml> is optional
    
  3. 打包并将 helm chart 发布到 NGC

    $ helm package <APP>-<VERSION>
    $ ngc registry chart push --org ORG_NAME --team TEAM_NAME ORG_NAME/TEAM_NAME/CHART_NAME:VERSION
    
  4. 更新部署脚本的 config-template.yml 以反映新 helm chart 的路径(本地或 repo)。下面提供了 config-template.yaml 中相关部分的片段。有关部署脚本的选项,请参阅 部署

app:
  configs:
    app_settings:
      # k8s_namespace:   '<replace-with-k8s-namespace-for-app-chart-to-deploy-defaults-to-app>'
      # helm_chart:
      # repo:
          # enable: <true/false-defaults-to-true>
          # repo_url:   '<replace-with-app-chart-helm-repo-url-defaults-to-https://helm.ngc.  nvidia.com/nvidia/ace>'
          # chart_name:   '<replace-with-app-chart-name-defaults-to-ucs-tokkio-app-base-3-stre  am-llm-rag-3d-ov>'
          # chart_version: '<replace-with-chart-version-defaults-to-'4.1.4'>'
          # release_name:   '<replace-with-release-name-for-helm-deploy-defaults-to-'tokkio-app'  >'
          # user_value_override_files:   ['list-of-absolute-path-of-value-override-files']
      # local:
          #  enable: <true/false-defaults-to-false>
          #  path: '<absolute-path-of-helm-chart-present-locally>'
          #  release_name:   '<replace-with-release-name-for-helm-deploy-defaults-to-'tokkio-app'  >'
          #  user_value_override_files:   ['list-of-absolute-path-of-value-override-files']
  1. 卸载先前安装的 Tokkio chart

    ./envbuild.sh uninstall --component app

  2. 运行部署脚本以安装更新的 chart。在下面显示的命令中使用 config-template 的正确路径和名称

    ./envbuild.sh install --component app --config-file ./config-template.yml