Provisioning and Install Automation for Tanzu Application Platform

Caution: This content of this repository is scheduled for archive in September 2024. Functionality here-in is being decomposed into individual repositories. Stay tuned!

Table of Contents

• Overview
• Benefits
• Prerequisites
• Getting Started
• Provisioning
• Installation
• Usage

Overview

:mega: The content of this repository is not commercially supported by VMware. Any issues arising from the content or usage of this repository are your responsibility.

Who is this for?

• Operators, SREs, Security and Compliance, Developers with some background in public cloud and Kubernetes

How might you exercise it?

• In the context of evaluations, workshops, and PoCs

Benefits

• For the community to perform quick evaluations
• Provisions all the underlying cloud infrastructure needed
  • e.g., Virtual networks, Kubernetes clusters, Container registries, DNS zones, Secrets management, Tools VM
• Installs either a single-cluster, full profile or multi-cluster (build, iterate, view and run profiles) installation of Tanzu Application Platform
• Useful for setup and delivery of workshops or PoCs in client environments by field engineering
  • Delivers a consistent experience for everyone involved

Overview video (3:30)

Prerequisites

Account credentials

• Github
• One or more on: AWS, Azure, Google Cloud, Oracle
• Tanzu Network
• VMware Marketplace

CLIs

• One or more of: aws, az, gcloud, oci
• docker
• git
• gh
• packer
• terraform

For your convenience a set of scripts exist to install a complement of the prerequisite toolset:

• MacOS >= 10.15
• Ubuntu >= 22.04
• Windows >= 10

However, if you already have Docker installed on your workstation or laptop, you might alternatively consider making use of this Docker toolset image.

Getting started

Start by forking this Github repository. You're required to configure your own set of Github secrets that will be leveraged by a collection of Github Actions. Consult the Configure Github Secrets section within each cloud target guide for the secrets to create. For your convenience a script exists to make this easier to do from the command line (it depends on you having exported named environment variables). See gh-set-secrets.sh.

If you're looking to contribute, clone your fork to your local workstation or laptop, create a branch and get to work on that new feature. This repo is open for pull requests.

To keep your fork up-to-date with upstream changes

git remote add upstream https://github.com/clicktruck/gha-workflows-with-gitops-for-tanzu-application-platform

Execute once

#! with git CLI
git fetch upstream
git merge upstream/main
git push

#! alternatively with gh CLI
gh repo sync --source clicktruck/gha-workflows-with-gitops-for-tanzu-application-platform

Execute periodically

Provisioning

With this repo

Provision the minimum set of cloud resources required for an installation

• Microsoft Azure
• Amazon Web Services
• Google Cloud Platform
• Oracle Cloud
• Tanzu Kubernetes Grid
  • on AWS

Elsewhere

• Service Installer for VMware Tanzu

  (Preferred) if you desire adherence to the Tanzu Reference Architecture

Installation

Want some TAP do you? There are a few pathways to achieve dial-tone, some more expedient than others.

Preferred

• Initiate install automation employing Github Action workflows targeting a cluster (or clusters)
  • Trigger a sample set of dispatch workflows from the command-line

Manual

• Consult the public Tanzu Application Platform installation documentation

Alternative

• Adopt a Gitops approach
  • via beta release of the reference implementation
  • via this repository's implementation

Usage

Once you have successfully installed Tanzu Application Platform, you may wish to consult the following supplemental documentation:

• Add or view Learning Center Workshops
• Working with the bastion host
  • Configuring the Remote SSH VS Code plugin and connecting to bastion host
  • Configuring remote live reload with Tanzu Developer Toolkit targeting a containerized app deployed on a Kubernetes cluster
• Consider using Visual Studio Code as your IDE
  • Add recommended extensions to your workspace
  • Setup Remote development over SSH

Also be sure to checkout these guides:

• Getting Started with the Tanzu Application Platform
• Getting started with multi-cluster Tanzu Application Platform
• Configure and deploy to multiple environments with custom parameters

Companion repositories:

• Accelerator samples use to bootstrap greenfield projects
• Curated sample applications use to demonstrate deploying workloads with kapp and ytt