Skip to main content

Manage Links in the Application

In this section, you will find a guide on how to add and manage links within your Application or Infrastructure through the StackSpot Portal.


You can add external tools to an Application or Infrastructure through links.

You can add two types of links:

  • Static links: they appear at the top of the Application dashboard and redirect the user to the URL.
    Static links you add in your Workspace, in the Application or Infrastructure section, are also available in the Application dashboard.

  • Embedded links: they allow you to add external links that appear as dashboards to enhance your Application. You can add Google Sheets tables, Grafana, Prometheus, Splunk charts, and others.

info
  • You can add static and embedded links to Stacks and Plugins.
  • If you add a Stack to your Application that already has a link, those links are added too. You cannot delete them.
  • This same scenario happens with links you add to a Workspace, where you created your Application.

Follow the steps below to add links:

Check the steps to add static links to your Application or Infrastructure:

Step 1. In your Workspace, go to the 'Applications' tab on the left menu; click the Application where you want to add a link.
If you want to add it to your Infrastructure, do the same but click the 'Infrastructure' section;

Step 2. On the dashboard, in the bar below the Application or Infrastructure name, click 'Add';

info

If you used a Stack with a link to create the Application or Infrastructure, you will see that link in the name bar after the deployment;

Step 3. Fill out the fields with the information. Here's an example:

  • 'Link name': Service Now;
  • 'URL': https://www.servicenow.com.br;
  • Logo: add an image. Optional.

Step 4. Click the 'Add link' button;

You have added a link to your Application or Infrastructure.

Follow the steps below:

Step 1. Go to your Application or Infrastructure dashboard; click the link you want to delete;

Step 2. An options menu appears with 'Copy link' and 'Delete link'. Click 'Delete link';

info
  • You cannot delete a static link that came from a Stack or a Plugin.
  • You cannot edit a static link. If you need to change it, delete it and then add a new one.

Follow the steps below:

Step 1. In your Workspace, go to the 'Applications' tab; click the Application where you want to add a link. If you want to add it to your Infrastructure, click the 'Infrastructure' section;

Step 2. On the dashboard, click the 'Add embedded link' button;

On the screen, add:

  • Link name (required);
  • URL link (required);

Make sure the link you add can be rendered in an iframe.

  • Link logo (optional).

Now, the embedded links are available in your Application or Infrastructure.

info

To edit or remove a link, click the 'More options' button (the button with three dots) and make your changes;

Go to your Application or Infrastructure dashboard on the StackSpot Platform. You can check every existing link in it.

These links can be:

  • Static links added directly to it;
  • Embedded links;
  • Static links added to the Workspace;
  • Static or embedded links from Stacks and Plugins.

You can manage the visibility of the links on the dashboard. To do this, follow the steps below:

Step 1. In the links bar on your Application or Infrastructure dashboard, click the double-arrow icon, then click 'Manage links';

Step 2. A modal with a search field and a list of all the links in your Application appears. Next to each link, there is a toggle button to enable or disable it:

  • Enable the button to hide the link from the dashboard;
  • Disable the button to keep the link visible on the dashboard;

Step 3. After setting it up, click 'Apply changes' at the bottom of the modal;

In the Manage links section, you can also delete links you added manually to your Application.

Add environment-specific URLs

You can add environment-specific URLs to your Applications without relying on links from Workspaces, Stacks, or Plugins. You can do this in the following ways:

  1. Using a command in the STK CLI;
  2. Using an Action.

1. Using the STK CLI command

Run the stk register app-deploy command in your Application's directory, providing the following parameter:

-er, --links TEXT

Supply a list of additional URLs for your Application. Each URL should be an object with the following structure: '[{"title": "<title>", "url": "<url>"}]'.

Example:

stk register app-deploy --links '[{"title": "stackspot", "url": "https://www.stackspot.com"}]'

2. Using an Action

Use an Action together with the StackSpot Workflow to add URLs to an Application.

View added URLs

Step 1. Go to the StackSpot EDP Portal;

Step 2. Select the Workspace where your Application was created;

Step 3. Open the Application. On the dashboard, click the 'View App' button;

To view URLs from a different environment, click the Environments box and select the environment you want.


See below an example of the 'View App' button on the Application dashboard in the StackSpot EDP Portal:

View App button in the Application dashboard in the StackSpot EDP Portal.