Launchpad

Get started with Cloud Pods Launchpad to share and inject Cloud Pods into your LocalStack instance via a URL

The LocalStack Cloud Pods Launchpad enables you to easily share and inject Cloud Pods into a LocalStack instance.

You can visit Cloud Pods launchpad to generate a shareable link for your pods.

Cloud Pods Launchpad Link Generator

Enter a public URL to your pod Cloud Pod the first input field, then click Generate Link. You can copy the resulting link and share it with others. Additionally, you have the option to copy a markdown snippet for quickly adding a badge to your repository.

Adding a badge to your repository

To add a badge to your README that links to the Cloud Pod Launchpad, you can include the following markdown snippet:

[![Launch LocalStack Cloudpod](https://localstack.cloud/gh/launch-pod-badge.svg)](https://app.localstack.cloud/launchpad?url=url_of_your_pod)

Cloud Pods Badge Demonstration

You need to include the url_of_your_pod as the url query parameter in the URL. For instance, if your Cloud Pod is hosted within the same repository, simply use the URL that directs to the raw Cloud Pod file.

Additionally, you can utilize the Link Generator to generate a shareable link for your pod and copy the corresponding markdown snippet for your repository. Check out a proper example on th Cloud Pod badge GitHub repository.

Troubleshooting common problems

In this section we present an overview of common problems and how to solve them.

LocalStack is not running

If your LocalStack instance is not running, you will encounter the following error message:

Cloud Pods Launchpad Error LocalStack not running

Start your LocalStack instance and attempt the operation once more. For detailed instructions on starting LocalStack, refer to the Getting Started section.

Failed to load metadata

If the launchpad encounters difficulties while loading the metadata of your pod, you will receive the following error message:

Cloud Pods Launchpad Error failed to load metadata

This can occur when the pod is no longer accessible or if the URL provided is invalid. Review the URL and attempt the operation once more.

Failed to inject pod

If the launchpad is unable to successfully inject the pod into your LocalStack instance, you will encounter a Pod injection failed message in the log. This issue may arise from various factors, such as version disparities. For further insights and information, please review your LocalStack logs.


Last modified January 26, 2024: rework state management docs (#1001) (1ec2b8b4e)