This topic describes how to install Application Accelerator for Tanzu 0.2.0 Beta.

Prerequisites

To join the Application Accelerator Beta program:

  1. Visit the App Accelerator for VMware Tanzu product page on Tanzu Network. Log in and confirm that you can view Release 0.2.0. If prompted, accept the EULA.

The following tools are required to install App Accelerator:

  • Carvel tools:
  • kubectl v1.17 and later. The kubectl CLI installed and authenticated with administrator rights for your target cluster.
  • Kubernetes v1.17 and later.
  • Flux2.

Install Application Accelerator for VMware Tanzu

Use the following procedure to install Application Accelerator for VMware Tanzu. To install, configure a cluster, create a namespace, deploy the server, and install an accelerator.

  1. Verify your Kubernetes cluster configuration. Run:

    kubectl config current-context
    kubectl cluster-info
    

Install Flux2

  1. Install the Flux2 dependency. Application Accelerator depends on the Source Controller component of Flux version 2.

    1. Run the following command to install Flux2:

      kapp deploy -a flux -f https://github.com/fluxcd/flux2/releases/download/v0.15.0/install.yaml
      
    2. (For TKG) The NetworkPolicy resources installed by Flux prevent access to the the Flux source controller service when using a TKG cluster. VMware recommends filtering out the NetworkPolicy resources by using the following command, instead of the command above, when installing Flux2 on TKG:

      kapp deploy -a flux -f https://github.com/fluxcd/flux2/releases/download/v0.15.0/install.yaml \
      --filter '{"not": {"resource": {"kinds": ["NetworkPolicy"]}}}'
      

      To remove any networkpolicies you have already installed with Flux, run:

      kubectl delete -n flux-system networkpolicies --all
      

Download and Deploy Application Accelerator

  1. Log in to Tanzu Network and accept the end user license agreement if needed. You can log in to Tanzu Network by navigating to Tanzu Network and then going to the App Accelerator for VMware Tanzu product page.

  2. Download the Application Accelerator installation bundle. You can download the installation bundle from the Application Accelerator for VMware Tanzu product page.

  3. Configure your authentication with the TanzuNet registry and provide your username and password at the prompts. Run:

    docker login registry.pivotal.io
    
  4. Pull and extract the installation bundle. Run:

    imgpkg pull -b registry.pivotal.io/app-accelerator/acc-install-bundle:0.2.0 \
    -o /tmp/acc-install-bundle
    
  5. Deploy Application Accelerator server. Use ytt, kbld and kapp to configure and deploy the bundle.

  6. Define properties for registry credentials.

    Provide registry credentials to use when pulling the image for deployment from the TanzuNet registry.

    You can use the following registry configuration properties:

    Property Required Default Description
    acc_registry__server No registry.pivotal.io The hostname for the registry where the App-Accelerator images are located
    acc_registry__username Yes The username to use for authenticating with the registry where the App-Accelerator images are located
    acc_registry__password Yes The password to use for authenticating with the registry where the App-Accelerator images are located
    1. To provide credentials for the Tanzu Network registry, run:

      export acc_registry__server=registry.pivotal.io
      export acc_registry__username=<username>
      export acc_registry__password=<password>
      
  7. Override configuration properties.

    You can override the following server and engine configuration properties:

    Property Required Default Description
    acc_server__service_type No LoadBalancer The service type for the acc-ui-server service (LoadBalancer, NodePort or ClusterIP)
    acc_server__watched_namespace No default The namespace that the server watches for accelerator resources
    acc_server__engine_invocation_url No http://acc-engine.accelerator-system.svc.cluster.local/invocations The URL to use for invoking the accelerator engine
    acc_engine__service_type No ClusterIP The service type for the acc-engine service (LoadBalancer, NodePort or ClusterIP)

    Note: For clusters that do not support the LoadBalancer service type you must override the default value for acc_server__service_type.

    1. To provide override values, export an environment variable with the name of the property set to the desired value. Run:

      export acc_server__PROPERTY-NAME=NodePort
      

      Where PROPERTY-NAME is the name of the property you want to configure.

  8. Deploy the bundle for Application Accelerator with any property overrides. Run:

    ytt -f /tmp/acc-install-bundle/config -f /tmp/acc-install-bundle/values.yml --data-values-env acc  \
    | kbld -f /tmp/acc-install-bundle/.imgpkg/images.yml -f- \
    | kapp deploy -y -a accelerator -f-
    
  9. Install the sample accelerators.

    You can download manifests for several sample accelerators from the Application Accelerator for VMware Tanzu product page.

    1. Download the sample-accelerators-0-2.yaml file for the 0.2.0 release from the Application Accelerator for VMware Tanzu product page.

    2. Apply the manifest file using kubectl. Run:

      kubectl apply -f sample-accelerators-0-2.yaml
      

Access the Application Accelerator UI server.

  1. List the resources deployed in the accelerator-system namespace:

    kubectl get -n accelerator-system service,deploy,pod
    

    The output will be similar to the following example:

    NAME                                                     TYPE        CLUSTER-IP      EXTERNAL-IP     PORT(S)    AGE
    service/acc-engine                                       ClusterIP   10.96.251.254   <none>          80/TCP     4h47m
    service/acc-ui-server                                    ClusterIP   10.96.74.16     35.192.88.120   80/TCP     6h15m
    service/accelerator-controller-manager-metrics-service   ClusterIP   10.96.8.89      <none>          8443/TCP   9h
    
    NAME                                             READY   UP-TO-DATE   AVAILABLE   AGE
    deployment.apps/acc-engine                       1/1     1            1           4h47m
    deployment.apps/acc-ui-server                    1/1     1            1           6h15m
    deployment.apps/accelerator-controller-manager   1/1     1            1           9h
    
    NAME                                                  READY   STATUS    RESTARTS   AGE
    pod/acc-engine-5bfd5954cc-5fglb                       1/1     Running   0          4h11m
    pod/acc-ui-server-659cd87f7c-9jfx5                    1/1     Running   0          3h54m
    pod/accelerator-controller-manager-5b57dcdcf7-2x9rr   1/1     Running   0          9h
    
  2. You can access the App Accelerator UI server using the listed EXTERNAL-IP address for the service acc-ui-server or by using the NodePort if your installation with NodePort.

    To port-forward the UI server, run the following command in a separate terminal:

    kubectl -n accelerator-system port-forward svc/acc-ui-server 8877:80
    
  3. Access the server at http://localhost:8877/dashboard/.

check-circle-line exclamation-circle-line close-line
Scroll to top icon