Configuring Apps Manager

This topic describes how to customize the Apps Manager deployed with Tanzu Application Service for Kubernetes (TAS for Kubernetes).

Overview

Apps Manager on TAS for Kubernetes provides a UI for:

  • Creating and deleting orgs, domains and spaces
  • Managing services, members, and permissions


Apps Manager configuration settings are stored in the apps-manager-values.yml configuration file. To create an Apps Manager configuration file: Create the Apps Manager Configuration File.

You can use Apps Manager’s default configuration, or you can customize Apps Manager in the following ways:

  • Customize the Marketplace
  • White-label the UI
  • Disable/Enable features

To customize your Apps Manager configuration: Configure Apps Manager.

For more information about Apps Manager, see Getting Started with Apps Manager.

Note: Users are currently unable to invite members to orgs and spaces through Apps Manager. This feature depends on the Notifications Service, which is not available on TAS for Kubernetes.

Prerequisites

Before customizing Apps Manager, complete the following:

Create the Apps Manager Configuration File

Create and store your Apps Manager configuration values file within the configuration-values directory used to store TAS for Kubernetes configuration values.

To create the apps-manager-values.yml Apps Manager configuration file:

  1. Open a command line and change directory to the parent directory that contains tanzu-application-service directory.
  2. Confirm there is a configuration-values subdirectory in this directory.

  3. To copy the Apps Manager Sample Values file as your baseline apps-manager-values.yml Apps Manager configuration:

    cp tanzu-application-service/sample-apps-manager-values.yml configuration-values/apps-manager-values.yml

Configure Apps Manager

You can customize Apps Manager by modifying the apps-manager-values.yml configuration file.

To customize Apps Manager:

  1. Change directory to the configuration-values directory.

  2. Edit the apps-manager-values.yml file.

  3. Complete one or more of the following:

Configure Apps Manager Base Settings

To configure Apps Manager base settings:

  1. Ensure the apps-manager-values.yml file has an apps_manager: section.
  2. Add the desired property configuration, using property: value format. See Configurable Apps Manager Base Settings below.

  3. Review the completed file. The configuration file should be a well formatted YAML file.
    For example:

    #@data/values
---
apps_manager:
  currency_lookup: {"usd":"$","eur":"€"}
  enable_displaying_plan_prices: "false"
  poll_interval: 30
  app_details_poll_interval: 10

Configurable Apps Manager Base Settings

The following are all of the configurable Apps Manager base settings:

Property Default Value Description
currency_lookup{“usd”:“$”,“eur”:“€”}Supported currency symbols
enable_displaying_plan_pricesfalseDisplay Marketplace Service Plan Prices
poll_interval30The Apps Manager poll interval. Enter value in seconds.
app_details_poll_interval10The app details polling interval. Enter value in seconds.

Configure Apps Manager White-Labeling

To configure Apps Manager White-Labeling settings:

  1. Ensure the apps-manager-values.yml file has an apps_manager: section.
  2. Ensure the apps_manager: section includes a whitelabeling: sub-section.
  3. Add the desired property configuration, using property: value format. See Configurable Apps Manager White-Label Settings below.

  4. Review the completed file. The configuration file should be a well formatted YAML file.
    For example:

    #@data/values
---
apps_manager:

  whitelabeling:
    product_name: "Apps Manager"
    accent_color: "#00A79D"
    favicon: ""
    footer_links: "[]"

  5. Save the configuration file.

Configurable Apps Manager White-Label Settings

The following are all of the configurable Apps Manager White-Label settings:

Property Default Value Description
app_icontanzu iconIcon for apps manager UAA portal link
company_name“VMware”Custom company name to display.
product_name“Apps Manager”Custom product name to display.
accent_color#00A79DCustom color for the app. Enter a hexadecimal color code. For example, “#71ffda”.
favicon“”Custom favicon. Enter a base64-encoded PNG image string, leaving out the mime-typ (data:image/png;base64,) string.
footer_links“[]”Json array of links for the footer (format ’[{“name”:“link”, “href”: “https://google.com”}]’
footer_text“”Custom footer text.
global_wrapper_bg_color“#D6D6D6”Classification header and footer background color. Enter a hexadecimal color code. For example, “#71ffda”.
global_wrapper_text_color“#333”Classification header and footer text color. Enter a hexadecimal color code. For example, “#71ffda”.
global_wrapper_footer_content“”Classification footer content. Enter plain text or HTML markup.
global_wrapper_header_content“”Classification header content. Enter plain text or HTML markup.
logo“”Custom logo. Enter a base64-encoded PNG image string, leaving out the mime-typ (data:image/png;base64,) string.
marketplace_name“Marketplace”Name of the marketplace. Enter plain text or HTML markup
marketplace_url“/marketplace”Apps Manager Marketplace link to point to a custom marketplace.
secondary_navigation_links’[{“name”:“Docs”,“href”:“https://docs.run.pivotal.io”},{“name”:“Tools”,“href”:“/tools”}]’List of secondary navigation links of Apps Manager. Enter json string.

Next Steps

After you complete this procedure, proceed to Installing Tanzu Application Service for Kubernetes.