(Experimental) Application Toolkit ¶

Application Toolkit package is a meta-package that installs a collection of packages for creating, iterating and managing applications

Supported Providers ¶

The following table shows the providers this package can work with.

Components ¶

• App Toolkit version: 0.1.0

Configuration ¶

Installation ¶

Prerequisites ¶

• The Tanzu CLI is installed, see Getting Started.
• The following steps require the Tanzu CLI app plugin. See here on how to install.
• You will need to provide a container registry for both kpack and the sample supply chain to leverage. In the examples below a free DockerHub account is shown, but you can reference the Tanzu Community Edition kpack documentation to see examples utilizing other registries.

Prepare a values.yaml file for local Docker installation without load balancer ¶

In the following example, you will deploy our traffic ingress mechanism, Contour, with a ClusterIP configuration, and Knative to serve as localhost. You will add these settings to a values.yaml file, and add a Docker registry for kpack to store buildpacks on. This example is one method of configuring App-toolkit, feel free to adapt the configuration to reflect your environment.

contour:
  envoy:
    service:
      type: ClusterIP
    hostPorts:
      enable: true

knative_serving:
  domain:
    type: real
    name: 127-0-0-1.sslip.io

kpack:
  kp_default_repository: https://index.docker.io/v1/
  kp_default_repository_username: [your username]
  kp_default_repository_password: [your password]

Install App-toolkit using the custom values file ¶

You can also change the default installation values by providing a file with predetermined values. In this documentation, we will refer to this file as values.yaml.

tanzu package install app-toolkit --package-name app-toolkit.community.tanzu.vmware.com --version 0.1.0 -f values.yaml -n tanzu-package-repo-global

Optional: Exclude packages ¶

To exclude certain packages, create or add to a values.yaml file the name of the excluded packages.

For example:

excluded_packages:
  - contour.community.tanzu.vmware.com
  - cert-manager.community.tanzu.vmware.com

Usage Example ¶

This example illustrates creating a simple Spring Boot web app on the locally deployed Tanzu Community Edition cluster using Docker.

1. Begin with Docker and the Tanzu CLI installed on your development machine and ensure you have the Carvel tools installed as well as we will be leveraging ytt in the examples below. For best performance ensure that you have plenty of free space on the local filesystem that Docker is using.

2. Create an unmanaged cluster named demo-local exposing 80 and 443 ports.

   tanzu unmanaged-cluster create demo-local -p 80:80 -p 443:443
   

3. Ensure you have installed the App-toolkit package. You can validate this by checking that all the packages have successfully reconciled using the command:

   tanzu package installed list -A
   

   You should see output similar to the following:

   tanzu package installed list -A
   | Retrieving installed packages...
     NAME                      PACKAGE-NAME                                         PACKAGE-VERSION        STATUS               NAMESPACE
     app-toolkit               app-toolkit.community.tanzu.vmware.com               0.1.0                  Reconcile succeeded  tanzu-package-repo-global
     cartographer              cartographer.community.tanzu.vmware.com              0.2.2                  Reconcile succeeded  tanzu-package-repo-global
     cert-manager              cert-manager.community.tanzu.vmware.com              1.6.1                  Reconcile succeeded  tanzu-package-repo-global
     contour                   contour.community.tanzu.vmware.com                   1.19.1                 Reconcile succeeded  tanzu-package-repo-global
     fluxcd-source-controller  fluxcd-source-controller.community.tanzu.vmware.com  0.21.2                 Reconcile succeeded  tanzu-package-repo-global
     knative-serving           knative-serving.community.tanzu.vmware.com           1.0.0                  Reconcile succeeded  tanzu-package-repo-global
     kpack                     kpack.community.tanzu.vmware.com                     0.5.1                  Reconcile succeeded  tanzu-package-repo-global
     cni                       antrea.tanzu.vmware.com                              0.13.3+vmware.1-tkg.1  Reconcile succeeded  tkg-system
   

4. You’ll now need to prepare a second values file (apart from the one used to install App-toolkit) with the additional configuration necessary for kpack and cartographer. In the below examples, this second values file will be referenced as supplychain-example-values.yaml.

   kpack:
     registry:
       url: [REGISTRY_URL]
       username: [REGISTRY_USERNAME]
       password: [REGISTRY_PASSWORD]
     builder:
       # path to the container repository where kpack build artifacts are stored
       tag: [REGISTRY_TAG]
     # A comma-separated list of languages e.g. [java,nodejs] that will be supported for development
     # Allowed values are:
     # - java
     # - nodejs
     # - dotnet-core
     # - go
     # - ruby
     # - php
     languages: [java]
     image_prefix: [REGISTRY_PREFIX]
   

   Where:

   • REGISTRY_URL is a valid OCI registry to store kpack images. For DockerHub this would be https://index.docker.io/v1/
   • REGISTRY_USERNAME and REGISTRY_PASSWORD are the credentials for the specified registry.
   • REGISTRY_TAG is the path to the container repository where kpack build artifacts are stored. For DockerHub, it is username/tag, e.g. csamp/builder
   • REGISTRY_PREFIX is the prefix for your images as they reside on the registry. For DockerHub, it is the username followed by a trailing slash, e.g. csamp/

5. Use ytt to insert the values from the above supplychain-example-values.yaml into the Kuberentes resource definitions below. You can inspect the files and see where

   ytt --data-values-file supplychain-example-values.yaml --ignore-unknown-comments -f https://raw.githubusercontent.com/krisapplegate/community-edition/main/addons/packages/app-toolkit/0.1.0/test/example_sc/rbac.yaml | kubectl apply -f -
   ytt --data-values-file supplychain-example-values.yaml --ignore-unknown-comments -f https://raw.githubusercontent.com/krisapplegate/community-edition/main/addons/packages/app-toolkit/0.1.0/test/example_sc/kpack-templates.yaml | kubectl apply -f -
   ytt --data-values-file supplychain-example-values.yaml --ignore-unknown-comments -f https://raw.githubusercontent.com/krisapplegate/community-edition/main/addons/packages/app-toolkit/0.1.0/test/example_sc/builder.yaml | kubectl apply -f -
   

6. Deploy the example supply chain

   ytt --data-values-file supplychain-example-values.yaml --ignore-unknown-comments -f https://raw.githubusercontent.com/krisapplegate/community-edition/main/addons/packages/app-toolkit/0.1.0/test/example_sc/supplychain.yaml | kubectl apply -f -
   

7. Deploy the Tanzu workload

   tanzu apps workload create -f https://raw.githubusercontent.com/cgsamp/tanzu-simple-web-app/main/example/workload.yaml
   

8. Watch the logs of the workload to see it build and deploy. You’ll know it’s complete when you see Build successful

   tanzu apps workload tail tanzu-simple-web-app
   

9. Access the workload’s url in your browser, or with curl

   curl http://tanzu-simple-web-app.default.127-0-0-1.sslip.io/