Generate an application with Application Accelerator

This topic guides you through how to generate a new project using Application Accelerator and how to deploy the project onto a Tanzu Application Platform (commonly known as TAP) cluster. For background information, see Application Accelerator.

Prerequisites

Before you start, complete all Getting Started prerequisites.

Generate a project using an Application Accelerator

There are multiple interfaces that you can use to generate a new project. The options are:

  • Application Accelerator extension for VS Code
  • Application Accelerator plug-in for IntelliJ
  • Tanzu Developer Portal

Choose one of the following tabs for how to generate and deploy applications using your selected interface. If you have already generated a project and want to skip this step, you can go to Deploying your application with Tanzu Application Platform.

VS Code
What you will do:
  • Install the Application Accelerator extension for VS Code.
  • (Optional) Provision a new GitHub repository and upload the project to the repository.
  • Generate a project using an Application Accelerator.

To generate a new project using an Application Accelerator:

  1. Install and configure the Application Accelerator extension for VS Code, see Application Accelerator Visual Studio Code extension.

  2. Select an accelerator from the catalog. This example uses Tanzu Java Web App.

    Selecting Tanzu Java Web App in the Visual Studio Code UI.

  3. In Configure Accelerator, configure the accelerator as defined by your project’s requirements. This example configures the project to use Spring Boot v3.0 and Java v17.

    The Configure Accelerator step in the Visual Studio Code UI. The check box for Spring Boot 3.0 is selected.

  4. Click Next Step.

  5. If your organization’s Tanzu Application Platform is configured for Git repository creation, configure the Setup Repository step using the following sub-steps. If not, click Skip and go to step 5.

    Note

    For information about configuring optional Git repository creation and supported repositories, see Create an Application Accelerator Git repository during project creation.

    1. Using the Providers drop-down menu, select your Git provider. For example, github.com.

    2. After you select the provider, a dialog box appears for you to enter an API token for your Git provider. Populate the text box with your provider’s API token and press Enter.

      This API key must be able to create new repositories for an organization or user. For information about how to create an API token for Git repository creation, see Creating a personal access token in the GitHub documentation.

      The Setup Repository step in the Visual Studio UI showing the dialog box to enter the personal access token for your provider.

    3. In the Owner text box, enter the name of either the GitHub organization or user name to create the repository under.

    4. In the Repository Name text box, enter the name of the project repository.

    5. In the Repository Branch text box, enter the name of the default branch for the project repository. Typically, this is set to main.

    6. Click Next Step.

  6. In the Review and Generate step, verify that all the information you provided is accurate, then click Generate Project.

  7. A dialog box appears for you to choose a location for the project to be stored on the local file system. Choose a directory or create a new one.

  8. After the project has generated, a second dialog box appears for you to open the new project in a new window. Click Yes.

  9. When opened, the project is ready for development.

IntelliJ
What you will do:
  • Install the Application Accelerator plug-in for IntelliJ.
  • Generate a project using an Application Accelerator.

To generate a new project using an Application Accelerator:

  1. Install and configure the Application Accelerator plug-in for IntelliJ, see Application Accelerator plugin for IntelliJ.

  2. On the Welcome to IntelliJ IDEA page, click New Project.

    The IntelliJ UI with the New Project button highlighted.

  3. Click Tanzu Application Accelerator in the left side panel.

    The IntelliJ UI with Tanzu Application Accelerator selected in the Generators list in the left panel.

  4. Select an accelerator from the catalog. This example uses Tanzu Java Web App.

  5. Click Next.

  6. In the Configure Options step, configure the accelerator as defined by your project’s requirements.

    The IntelliJ UI showing the Configure Options pane for the Tanzu Java Web App accelerator with the fields filled in.

  7. Click Next.

  8. In the Review and Generate step, verify that all the information provided is accurate then click Next.

  9. After the project has generated, click Create to open the new project in IntelliJ.

  10. When opened, the project is ready for development.

Tanzu Developer Portal
In this example, you use the Tanzu-Java-Web-App accelerator. You also use Tanzu Developer Portal. For information about connecting to Tanzu Developer Portal, see Access Tanzu Developer Portal.

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.

To generate a new project using an Application Accelerator:

  1. From Tanzu Developer 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 Developer Portal.

  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../install-online/install.hbs.md profiles.

    Screenshot of the Tanzu Java Web App accelerator form in Tanzu Developer Portal.

  4. Click NEXT.

  5. 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.

    Note

    For information about configuring optional Git repository creation and supported repositories, see Create an Application Accelerator Git repository during project creation.

    1. Select the Create Git repo? check box.
    2. Select the host Git repository provider from the Host drop-down menu. For example, github.com.
    3. Populate the Owner and Repository text boxes.

      Screenshot of the git repository creation form in Tanzu Developer Portal.

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

    5. Click NEXT.

  6. Verify the provided information, and click GENERATE ACCELERATOR.

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

  8. 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.


Learn more about Application Accelerator

Next Steps

Now that you have generated a project that is ready for Tanzu Application Platform, learn how to quickly deploy the application on a Tanzu Application Platform cluster in Deploy an app on Tanzu Application Platform.

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