Deploy your first application on Tanzu Application Platform

This is the first in a series of Getting started how-to guides for developers. It walks you through deploying your first application on Tanzu Application Platform by using Tanzu Application Platform GUI.

Note

This walkthrough uses Tanzu Application Platform GUI. Alternatively, you can deploy your first application on Tanzu Application Platform using the Application Accelerator Extension for VS Code.

What you will do

  • Generate a project from an application accelerator.
  • (Optional) Provision a new Git repository for the project.
  • Upload it to your Git repository of choice.
  • Deploy the app using the Tanzu CLI.
  • View the build and runtime logs for your app.
  • View the web app in your browser.
  • (Optional) Add your application to Tanzu Application Platform GUI software catalog.

Before you start, complete all Getting started prerequisites. For background on application accelerators, see Application Accelerator.

Generate a new project using an application accelerator

In this example, you use the Tanzu-Java-Web-App accelerator. You also use Tanzu Application Platform GUI. For information about connecting to Tanzu Application Platform GUI, see Accessing Tanzu Application Platform GUI.

  1. From Tanzu Application Platform GUI portal, click Create located on the left side of the navigation pane to see the list of available accelerators.

    Screenshot of the Accelerators page showing list of available accelerators in Tanzu Application Platform GUI.

  2. Locate the Tanzu Java Web App accelerator and click CHOOSE.

  3. In the Generate Accelerators dialog box, replace the default value dev.local in the prefix for container image registry text box with the registry in the form of SERVER-NAME/REPO-NAME. The SERVER-NAME/REPO-NAME must match what was specified for registry as part of the installation values for ootb_supply_chain_basic. See the Full Profile section on Installing Tanzu Application Platform package and profiles. Click NEXT.

    Screenshot of the Tanzu Java Web App accelerator form in Tanzu Application Platform GUI.

  4. If your instance has optional Git repository support enabled, continue with the following sub-steps. If your instance does not support this, skip to step 5, “Verify the provided information.”

    1. Select Create Git repo?
    2. Select the Host Git repository provider from the drop-down menu. In this example, select github.com.
    3. Populate the Owner and Repository properties.

      Screenshot of the git repository creation form in Tanzu Application Platform GUI.

    4. As you are populating the form, a dialog box appears asking for permission to provision Git repositories. Follow the prompts and continue.

    5. Click NEXT.
  5. Verify the provided information, and click GENERATE ACCELERATOR.

  6. After the Task Activity processes complete, click DOWNLOAD ZIP FILE.

  7. After downloading the ZIP file, expand it in a workspace directory. If you did not create a Git repository in the preceding steps, follow your preferred procedure for uploading the generated project files to a Git repository for your new project.

Deploy your application through Tanzu Application Platform GUI

  1. Set up environment variables by running:

    export GIT_URL_TO_REPO=GIT-URL-TO-PROJECT-REPO
    export YOUR_NAMESPACE=YOUR-DEVELOPER-NAMESPACE
    

    Where:

    • GIT-URL-TO-PROJECT-REPO is the path you uploaded to earlier.
    • YOUR-DEVELOPER-NAMESPACE is the namespace configured earlier.
  2. Deploy the Tanzu Java Web App accelerator by running the tanzu apps workload create command:

    tanzu apps workload create tanzu-java-web-app \
    --git-repo ${GIT_URL_TO_REPO} \
    --git-branch main \
    --type web \
    --label app.kubernetes.io/part-of=tanzu-java-web-app \
    --yes \
    --namespace ${YOUR_NAMESPACE}
    

    If you bypassed step 5 or were unable to upload your accelerator to a Git repository, use the following public version to test:

    tanzu apps workload create tanzu-java-web-app \
    --git-repo https://github.com/vmware-tanzu/application-accelerator-samples \
    --sub-path tanzu-java-web-app \
    --git-branch main \
    --type web \
    --label app.kubernetes.io/part-of=tanzu-java-web-app \
    --yes \
    --namespace YOUR-DEVELOPER-NAMESPACE
    

    Where YOUR-DEVELOPER-NAMESPACE is the namespace configured earlier.

    For more information, see Tanzu Apps Workload Create.

    Note

    This deployment uses an accelerator source from Git, but in later steps you use the VS Code extension to debug and live-update this application.

  3. View the build and runtime logs for your app by running the tail command:

    tanzu apps workload tail tanzu-java-web-app --since 10m --timestamp --namespace YOUR-DEVELOPER-NAMESPACE
    

    Where YOUR-DEVELOPER-NAMESPACE is the namespace configured earlier.

  4. After the workload is built and running, you can view the web app in your browser. View the URL of the web app by running the following command and then press ctrl-click on the Workload Knative Services URL at the bottom of the command output.

    tanzu apps workload get tanzu-java-web-app --namespace YOUR-DEVELOPER-NAMESPACE
    

    Where YOUR-DEVELOPER-NAMESPACE is the namespace configured earlier.

    Screenshot of the Tanzu Java Web App default screen in a browser.

Add your application to Tanzu Application Platform GUI software catalog

  1. Navigate to the home page of Tanzu Application Platform GUI and click Home, located on the left navigation pane. Click REGISTER ENTITY.

    Screenshot of Tanzu Application Platform GUI Home page, with REGISTER Entity button highlighted.

    Alternatively, you can add a link to the catalog-info.yaml to the tap-values.yaml configuration file in the tap_gui.app_config.catalog.locations section. See Installing the Tanzu Application Platform Package and Profiles.

  2. Register an existing component prompts you to type a repository URL. Type the link to the catalog-info.yaml file of the tanzu-java-web-app in the Git repository text box. For example, https://github.com/USERNAME/PROJECTNAME/blob/main/catalog-info.yaml.

  3. Click ANALYZE.

    Screenshot of the page to register an existing component, showing Repository URL text box and Analyze button.

  4. Review the catalog entities to be added and click IMPORT.

    Screenshot of page for reviewing catalog entities to be added, showing entity details and Import button.

  5. Navigate back to the home page. The catalog changes and entries are visible for further inspection.

Note

If your Tanzu Application Platform GUI instance does not have a PostgreSQL database configured, the catalog-info.yaml location must be re-registered after the instance is restarted or upgraded.

Next steps

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