Erlo

TAP 系列文章2 | Tanzu Application Platform v1.1 安装配置步骤

收藏 2022-06-09 11:30:05   201   开源中国
页面报错/反馈
点赞

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安装包

  • 登录 Tanzu Network注册并下载Tanzu Application Platfrom v1.1 packages;
  • 保证TAP的安装K8S Cluster Worker的网络能够访问:https://registry.tanzu.vmware.com

DNS Records的准备

  • 准备应用部署后的访问域名,利用TAP部署的应用,部署完成后可以直接利用配置的域名进行访问;安装前需要准备好这个域名;例如:.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
  • 验证 Tanzu CLI 的安装
# 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 Iterate 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
  • 安装TAP Iterate 环境安装后的验证

安装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 Full 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 部署后,功能验证

  • 创建应用运行Domain与租户配置

运行在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托管的Web类型应用

在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云原生

登录查看全部

参与评论

评论留言

还没有评论留言,赶紧来抢楼吧~~

返回顶部

给这篇文章打个标签吧~

棒极了 糟糕透顶 好文章 PHP JAVA JS 小程序 Python SEO MySql 确认