Tanzu Application Platform v1.1安装配置步骤
![]()
如上图所示，Tanzu Application Platform v1.1的安装，主要分成以下步骤：
- TAP安装前的准备；
- 安装Tanzu CLI命令行工具与Tanzu Cluster Essentials（Tanzu K8S安装包管理套件）；
- 根据集群的使用角色，参考前文提到的内容，准备TAP Profiles配置文件tap-values.yaml；
- 安装Tanzu Application Platform v1.1；
- 验证安装环境 ；
TAP 安装前的准备
注意：Tanzu Application Platform v1.1的官方安装说明参考如下位置，本文旨在帮助初次安装TAP的用户快速配置和构建TAP运行环境。
注意：本文安装过程中的桌面CLI环境基于MacOS&Linux 操作系统。对于Windows CLI环境的操作请参考官方安装文档。
准备VMware Tanzu Network登录账号并下载TAP安装包
DNS Records的准备
- 准备应用部署后的访问域名，利用TAP部署的应用，部署完成后可以直接利用配置的域名进行访问；安装前需要准备好这个域名；例如：<app-name>.tap-app.example.vmware.com
Kubernetes Cluster运行环境的准备
当前TAP v1.1支持的Upstream Kubernetes版本：v1.21，v1.22，v1.23；
当前支持的K8S发行版的提供商：
- Azure Kubernetes Service
- Amazon Elastic Kubernetes Service
- Google Kubernetes Engine
- Tanzu Kubernetes Grid multicloud
- vSphere with Tanzu v7.0 U3a
TAP 安装Tanzu CLI命令行工具与Tanzu Cluster Essentials
- 下载 VMware Tanzu Application Platform tanzu-cli，根据安装桌面OS下载 ( tanzu-framework-bundle-windows, tanzu-framework-bundle-mac, or tanzu-framework-bundle-linux)
- 安装 Tanzu CLI for Linux
# Move to the folder containing the downloaded file.
cd ~/Downloads
# Make a directory to extract the archive into
mkdir tanzu
# Extract the tar archive into your ~/tanzu directory
tar -xvf tanzu-framework-linux-amd64.tar -C ./tanzu
# Change your working directory to the extracted archive directory.
cd tanzu
# Run the install binary to complete the base installation.
sudo install cli/core/v0.11.2/tanzu-core-linux_amd64 /usr/local/bin/tanzu
# Install the Tanzu CLI Plugins
export TANZU_CLI_NO_INIT="true"
tanzu plugin install --local cli all
# Expect version: v0.11.2
tanzu version
# Expect the package, secret, apps, services, and accelerator plugins to have a STATUS of 'installed'
tanzu plugin list
安装TAP Cluster Essentials 套件
前文说过，为了简化、角色化TAP 的K8S环境安装；VMware TAP team准备了标准化的TAP安装套件，简化TAP的安装、配置(模板参数化，定制化)、升级(Upgrade)、模块参数更新；这些Ops功能，由TAP Cluster Essentials套件负责帮助客户完成。
下面的安装过程仍然以Liunx系统作为客户的参考：
# Move to the Downloads folder
cd ~/Downloads
# Specify the VMware Cluster Essentials for Tanzu bundle details
export INSTALL_BUNDLE="registry.tanzu.vmware.com/tanzu-cluster-essentials/cluster-essentials-bundle@sha256:ab0a3539da241a6ea59c75c0743e9058511d7c56312ea3906178ec0f3491f51d"
export INSTALL_REGISTRY_HOSTNAME="registry.tanzu.vmware.com"
export INSTALL_REGISTRY_USERNAME='' # <- Insert Your Tanzu Network username
export INSTALL_REGISTRY_PASSWORD='' # <- Insert Your Tanzu Network password
# Make a folder for the extracted archive files
mkdir tanzu-cluster-essentials
# Extract the archive
tar -xvf tanzu-cluster-essentials-linux-amd64-1.1.0.tgz -C ./tanzu-cluster-essentials
# Move to the extracted folder
cd tanzu-cluster-essentials
# Install VMware Cluster Essentials for Tanzu
./install.sh
# Ensure that kapp-controller and secretgen-controller are ‘running’
kubectl get pods --all-namespaces
安装Tanzu Application Platform v1.1 – 安装包工具集
前文提到TAP的安装需要考虑使用的角色，采用合适的参考架构作为部署参考；下面的安装，假设的使用角色是Ops工程师，计划在单一的K8S环境中验证TAP的全部功能，采用Full Profile配置；未来再考虑参考架构中提到的多角色，多集群配置的场景；
事实上，多角色、多集群的TAP部署 ( Iterate、Build、Run、TAP GUI)，在步骤上跟下面提到的安装完全一致，区别在于tap-values.yml 文件的参数配置；本文通过full profiles的tap-values.yml给大家展示，用户可以根据集群的角色，自行裁剪full profiles的tap-values.yml以满足多集群部署的需求；更为详细的多集群部署需要注意的参数配置，请参考官方TAP安装文档；
- 准备 Tanzu Application Platform 应用bundle安装环境参数
# Create Tanzu Application Platform Install Environment Variables
export TAP_VERSION="1.1.0"
export TAP_NAMESPACE="tap-install"
export DOMAIN="example.com"
export APPS_DOMAIN="apps.example.com"
# Set the developer’s ‘push’ capable docker container registry details
export DOCKER_SERVER="https://index.docker.io/v1/"
export DOCKER_USERNAME='' # < Insert Your Docker Hub username
export DOCKER_PASSWORD='' # < Insert Your Docker Hub password (or Access Token if 2FA is enabled)
kubectl create ns $TAP_NAMESPACE
- 准备 Tanzu Application Platform 应用bundle Tanzu Network 下载用户配置
tanzu secret registry add tap-registry \
--username $INSTALL_REGISTRY_USERNAME \
--password $INSTALL_REGISTRY_PASSWORD \
--server $INSTALL_REGISTRY_HOSTNAME \
--namespace $TAP_NAMESPACE \
--export-to-all-namespaces \
--yes
- 安装 Tanzu Application Platform 应用bundle
tanzu package repository add tanzu-tap-repository \
--url $INSTALL_REGISTRY_HOSTNAME/tanzu-application-platform/tap-packages:$TAP_VERSION \
--namespace $TAP_NAMESPACE
- 安装 Tanzu Application Platform 应用bundle，验证
# Check for STATUS: “Reconcile succeeded”
tanzu package repository get tanzu-tap-repository --namespace $TAP_NAMESPACE
# Check for a big list of ready to use packages
tanzu package available list --namespace $TAP_NAMESPACE
注意：Tanzu Application Platform安装的过程中，受到客户网络环境的影响，可能会发生tanzu CLI 超时退出的情况，这个时候无需对安装过程进行干扰，系统会继续安装，直至安装成功；
安装Tanzu Application Platform v1.1 – Iterate Profile 开发环境
TAP Iterate Profile 的安装主要针对Dev团队这个角色，当然也可以作为Ops团队熟悉TAP时构建的测试环境；另外，TAP 的Iterate环境也比较适合ISV作为COTS的应用的开发、调试环境；
- 下载并配置 Iterate Profile tap-values.yml
注意： 下面操作的运行依赖于前面章节配置的环境变量；
# Download the template file.
curl -o template-tap-values.yml https://raw.githubusercontent.com/benwilcock/TAPonLAP/main/TAPonLAPv1.1/template-tap-values-nix.yml
# Customize the template using the environment variables you created in step 1.
envsubst < template-tap-values.yml > tap-values.yml
![]()
注意：TAP 的安装依赖于主机/Host性能、网络带宽等因素的影响，可能需要比较久的时间；在此期间如果发生tanzu CLI退出的情况，无需进行人工调试，等待至少45min后再通过基本的Kubernetes调试技巧进行故障排查。
tanzu package install tap -p tap.tanzu.vmware.com -v $TAP_VERSION \
--values-file tap-values.yml \
--poll-timeout 45m \
--namespace $TAP_NAMESPACE
![]()
安装Tanzu Application Platform v1.1 – Full Profile 环境
TAP full profile的安装过程跟 TAP Iterate profile非常接近，主要的不同点就是tap-values.yml的准备；客户可以自行参考TAP v1.1官方安装手册中的full profile建议的tap-values.yml，作为安装初始配置，进行定制化，位置如下：
https://docs.vmware.com/en/Tanzu-Application-Platform/1.1/tap/GUID-install.html#install-profile
![]()
注意：TAP 的安装依赖于主机/Host性能、网络带宽等因素的影响，可能需要比较久的时间；在此期间如果发生tanzu CLI退出的情况，无需进行人工调试，等待至少45min后再通过基本的Kubernetes调试技巧进行故障排查。
tanzu package install tap -p tap.tanzu.vmware.com -v $TAP_VERSION \
--values-file tap-values.yml \
--poll-timeout 45m \
--namespace $TAP_NAMESPACE
Tanzu Application Platform v1.1 部署后，功能验证
运行在TAP中的托管应用，通过Kubernetes Namespace进行租户隔离；同时根据租户应用所在的Namespace，分配一个访问应用的URL，供应用的使用者访问；
下面的步骤，用来创建租户应用的Kubernetes Namespace：
# Set the developer namespace value to 'default'
export TAP_DEV_NAMESPACE="default"
# Create a namespace for the developer to work in
kubectl create ns $TAP_DEV_NAMESPACE
# Add the secret for the BUILD Container Registry
tanzu secret registry add registry-credentials \
--server $DOCKER_SERVER \
--username $DOCKER_USERNAME \
--password $DOCKER_PASSWORD \
--namespace $TAP_DEV_NAMESPACE
# Obtain the service accounts file
curl -o serviceaccounts.yml https://raw.githubusercontent.com/benwilcock/TAPonLAP/main/TAPonLAPv1.1/serviceaccounts.yml
# Add the necessary RBAC Roles, Accounts, Bindings etc...
kubectl -n $TAP_DEV_NAMESPACE apply -f "serviceaccounts.yml"
在TAP的环境中，可以运行不同类型(风格)的应用，例如：传统Spring MVC风格的应用，或者基于Microservice架构的API风格的应用，比如：SpringBoot + Spring Cloud Service 类型的应用；下面的例子，演示一个基于Spring Boot的API风格的应用通过TAP进行安装、运行和访问和托管；其它风格的应用的部署，参考官方文档或者咨询VMware专家；
利用Tanzu TAP运行基于K8S的Web或者API应用，无需使用者提前进行OCI镜像的打包；平台服务负责应用OCI镜像的构建与K8S部署模板的实例化；TAP 开箱即用的模板引擎，甚至还负责应用的配置管理与蓝绿发布，K8S Reliability等模板的实例化，极大的简化了Dev对K8S的应用流程；
# Create the workload
tanzu apps workload create tanzu-java-web-app \
--git-repo https://github.com/sample-accelerators/tanzu-java-web-app \
--git-branch main \
--type web \
--label app.kubernetes.io/part-of=tanzu-java-web-app \
--label tanzu.app.live.view=true \
--label tanzu.app.live.view.application.name=tanzu-java-web-app \
--annotation autoscaling.knative.dev/minScale=1 \
--namespace $TAP_DEV_NAMESPACE \
--yes
# Watch the platform build the workload. Press Ctrl-C to exit.
tanzu apps workload tail tanzu-java-web-app --since 10m --timestamp
安装成功后的验证如下：
![]()
结束语
Tanzu Application Platform的安装具有高度的可定制以满足不同场景，角色，可用性等配置与安装需求；相信读者在实践TAP的安装过程中，一定会遇到特殊的配置场景，环境等因素导致安装失败；这种情况，请阅读TAPv1.0官方安装手册，里面有更为详细的配置与环境说明；Troubleshooting技巧与工具的使用，以及遇到特殊问题后的Support渠道说明；
作者简介：
毕建华，VMware大中华区应用现代化部门高级解决方案架构师。多年来一直从事云原生相关领域工作，包括系统设计以及参与多种容器调度平台开发，部署，运维工作；包括，基于Mesos、DCOS平台，开发Dbaas框架；参与Kubernetes开源项目KUDO的开发与推广；CNCF认证CKA工程师；VMware认证Spring Professional工程师。
来源｜公众号：VMwareTanzu云原生
