Extensions done

The docker extension file needs to move somewhere else but it is done

Author: remotesynth

astro.config.mjs

@@ -148,9 +148,28 @@ export default defineConfig({
                 },
                 {
                   label: 'Extensions',
-                  autogenerate: {
-                    directory: '/aws/tooling/extensions',
-                  },
+                  items: [
+                    {
+                      label: 'Overview',
+                      slug: 'aws/tooling/extensions',
+                    },
+                    {
+                      label: 'Managing Extensions',
+                      slug: 'aws/tooling/extensions/managing-extensions',
+                    },
+                    {
+                      label: 'Developing Extensions',
+                      slug: 'aws/tooling/extensions/developing-extensions',
+                    },
+                    {
+                      label: 'Extensions Library',
+                      slug: 'aws/tooling/extensions/extensions-library',
+                    },
+                    {
+                      label: 'Official Extensions',
+                      link: 'https://app.localstack.cloud/extensions/library/',
+                    },
+                  ],
                   collapsed: true,
                 },
                 {

public/images/aws/localstack-extensions-header.png

@@ -6,6 +6,8 @@ sidebar:
     order: 4
 ---
 
+import { FileTree } from '@astrojs/starlight/components';
+
 ## Introduction
 
 This section provides a brief overview of how to develop your own extensions.
@@ -101,12 +103,12 @@ class ReadyAnnouncerExtension(Extension):
      LOG.info("my plugin is loaded and localstack is ready to roll!")
 ```
 
-{{< callout >}}
+:::note
 A note on importing LocalStack modules: since extensions run in the same Python process as the LocalStack runtime,
 you can also import other LocalStack modules outside the `localstack.extensions.api` module, and work with them.
 However, be aware that these modules are not part of our public API, and can change even with patch versions any time.
 Your extension may break in unexpected ways, and we cannot provide support for internal APIs.
-{{</callout>}}
+:::
 
 ## Packaging extensions
 
@@ -172,7 +174,7 @@ Commands:
 First, create a new extension from a template.
 To use `localstack extensions dev new`, you will also need to install [cookiecutter](https://github.com/cookiecutter/cookiecutter) via `pip install cookiecutter`.
 
-{{< command >}}
+```bash
 $ localstack extensions dev new
 project_name [My LocalStack Extension]:
 project_short_description [All the boilerplate you need to create a LocalStack extension.]:
@@ -182,37 +184,37 @@ full_name [Jane Doe]:
 email [[email protected]]:
 github_username [janedoe]:
 version [0.1.0]:
-{{< / command >}}
+```
 
 This will create a new Python project with the following layout:
 
-```bash
-my-localstack-extension
-├── Makefile
-├── my_localstack_extension
-│  ├── extension.py
-│  └── __init__.py
-├── README.md
-├── setup.cfg
-└── setup.py
-```
+<FileTree>
+- my-localstack-extension
+  - Makefile
+  - my_localstack_extension
+    - extension.py
+    - __init__.py
+  - README.md
+  - setup.cfg
+  - setup.py
+</FileTree>
 
 Then run `make install` in the newly created project to make a distribution package.
 
 ### Start LocalStack with the extension
 
 To start LocalStack with the extension in dev mode, first enable it by running:
 
-{{< command >}}
+```bash
 $ localstack extensions dev enable ./my-localstack-extension
-{{< / command >}}
+```
 
 Then, start LocalStack with `EXTENSION_DEV_MODE=1`
 
-{{< command >}}
+```bash
 $ EXTENSION_DEV_MODE=1 LOCALSTACK_AUTH_TOKEN=...
 localstack start
-{{< / command >}}
+```
 
 In the LocalStack logs you should then see something like:
 
@@ -230,9 +232,10 @@ Now, when you make changes to your extensions, you just need to restart LocalSta
 
 Once your extension is ready to be used, release it on a public GitHub repository.
 To make your extension easily installable for everyone generate an extension badge for your extension on this page.
-The resulting badge should look like this <img src="https://localstack.cloud/gh/extension-badge.svg" alt="Extension badge">.
-You can create a one-click installer for your extension using our [Extension Installer](https://app.localstack.cloud/extensions/remote).
+The resulting badge should look like this:
+
+![Extension badge](https://localstack.cloud/gh/extension-badge.svg)
 
-{{< figure src="extension-installer.png" >}}
+You can create a one-click installer for your extension using our [Extension Installer](https://app.localstack.cloud/extensions/remote).
 
-<!-- TODO: add screenshot of installer with a specific extension, currently doesn't work -->
+![Extension Installer](/images/aws/extension-installer.png)

…ling/extensions/developing-extensions.md …ing/extensions/developing-extensions.mdxsrc/content/docs/aws/tooling/extensions/developing-extensions.md renamed to src/content/docs/aws/tooling/extensions/developing-extensions.mdx src/content/docs/aws/tooling/extensions/developing-extensions.md renamed to src/content/docs/aws/tooling/extensions/developing-extensions.mdx

@@ -13,7 +13,7 @@ A LocalStack extension is a Python application that runs together with LocalStac
 
 LocalStack extensions are available to licensed users, and the list of available extensions can be found in the [Extensions Library](https://app.localstack.cloud/extensions/library).
 
-<img src="extensions-library-ui.png" alt="LocalStack Extensions Library" title="LocalStack Extensions Library" width="900" />
+![LocalStack Extensions Library](/images/aws/extensions-library-ui.png)
 
 ## Installing an Extension
 
@@ -29,4 +29,4 @@ Click **Continue** to proceed.
 You can further manage the installed extensions by navigating to the **Extensions** tab in the LocalStack Instance page.
 You can remove an Extension by clicking the **Remove** button.
 
-<img src="extensions-library-management.png" alt="Installed LocalStack Extensions Library" title="Installed LocalStack Extensions Library" width="900" />
+![Installed LocalStack Extensions Library](/images/aws/extensions-library-management.png)

src/content/docs/aws/tooling/extensions/extensions-library.md

@@ -22,7 +22,7 @@ In this guide, you will install and use the [official MailHog extension for Loca
 To get started, start your LocalStack instance with your `LOCALSTACK_AUTH_TOKEN`.
 Access our [Extension Manager](https://app.localstack.cloud/inst/default/extensions/manage), and click the **Install** button for the MailHog extension.
 
-{{< figure src="install-extensions.png" alt="Extensions Manager" width="800">}}
+![Extensions Manager](/images/aws/install-extensions.png)
 
 You'll receive a confirmation prompt indicating that LocalStack container will restart, after which the extension will become accessible.
 Check your LocalStack logs for MailHog extension output, where you should see relevant logging information:
@@ -47,33 +47,33 @@ You can use the [`VerifyEmailIdentity`](https://docs.aws.amazon.com/cli/latest/r
 This is a required step before you can send emails from SES.
 Run the following command to verify an email address:
 
-{{< command >}}
+```bash
 $ aws --endpoint-url=http://localhost:4566 \
     ses verify-email-identity --email-address [email protected]
-{{< /command >}}
+```
 
 You can further send an email using the [`SendEmail`](https://docs.aws.amazon.com/cli/latest/reference/ses/send-email.html) API.
 Run the following command to send an email:
 
-{{< command >}}
+```bash
 $ aws --endpoint-url=http://localhost:4566 \
     ses send-email \
     --from [email protected] \
     --message 'Body={Text={Data="Hello from LocalStack to MailHog"}},Subject={Data=Test Email}' \
     --destination '[email protected]'
-{{< /command >}}
+```
 
 ### Navigate to Extension UI
 
 Navigate in your browser to the [MailHog UI in LocalStack](http://mailhog.localhost.localstack.cloud:4566/).
 You should see the email you sent in the MailHog UI.
 
-{{< figure src="mailhog.png" alt="Mailhog UI" width="800">}}
+![Mailhog UI](/images/aws/mailhog.png)
 
 ## Next steps
 
 - Explore our collection of official extensions, along with a growing ecosystem of third-party extensions, in our [Extensions Library](https://app.localstack.cloud/extensions/library).
 - Learn about the various methods for extension management and automating their installation when using LocalStack in a CI environment.
-  Get detailed insights from our [Managing Extensions]({{< ref "managing-extensions" >}}) guide.
+  Get detailed insights from our [Managing Extensions](/aws/tooling/extensions/managing-extensions) guide.
 - Want to create your own extensions?
-  Dive into our guide on [Developing Extensions]({{< ref "developing-extensions" >}}) for step-by-step instructions.
+  Dive into our guide on [Developing Extensions](/aws/tooling/extensions/developing-extensions) for step-by-step instructions.

src/content/docs/aws/tooling/extensions/getting-started.md

@@ -6,7 +6,8 @@ sidebar:
     order: 1
 ---
 
-{{< figure src="https://user-images.githubusercontent.com/3996682/184503940-c30bfcac-e049-4ee4-b905-207b340111d1.png" >}}
+
+![LocalStack Extensions](/images/aws/localstack-extensions-header.png)
 
 LocalStack Extensions allow developers to extend and customize LocalStack.
 Extensions are a feature of our paid offering.
@@ -21,10 +22,10 @@ You can use LocalStack Extensions to:
 - Instrumenting AWS requests with additional information before they reach your Lambdas.
 - Logging AWS API calls to custom data backends.
 
-The officially supported [LocalStack Extensions]({{< ref "user-guide/extensions/official-extensions" >}}) can be discovered on our [Extension Library](https://app.localstack.cloud/extensions/library).
+The officially supported [LocalStack Extensions]({/aws/tooling/extensions/official-extensions) can be discovered on our [Extension Library](https://app.localstack.cloud/extensions/library).
 To install and use extensions, you need an active LocalStack license.
 
-{{< callout >}}
+:::note
 The feature and the API are currently in a preview stage and may be subject to change.
 Please report any issues or feature requests on [LocalStack Extension's GitHub repository](https://github.com/localstack/localstack-extensions).
-{{< /callout >}}
+:::

src/content/docs/aws/tooling/extensions/index.md

@@ -11,33 +11,32 @@ sidebar:
 The LocalStack Extension for Docker Desktop enables developers working with LocalStack to operate their LocalStack container via Docker Desktop, including checking service status, container logs, and configuring profiles.
 To install the LocalStack Extension for Docker Desktop, you need to have [Docker Desktop installed on your machine](https://www.docker.com/products/docker-desktop).
 
-<img src="localstack-docker-extension.png" alt="LocalStack Extension for Docker Desktop" title="LocalStack Extension for Docker Desktop" width="800px"   />
+![LocalStack Extension for Docker Desktop](/images/aws/localstack-docker-extension.png)
 
 ## Installation
 
 To utilize LocalStack's Docker Extension, it is necessary to have a recent version of Docker Desktop (v4.8 or higher) installed on the local machine.
 To enable the extension, access the **Extensions** tab and select the **Enable Docker Extensions** and **Show Docker Extensions system containers** option.
 
-<img src="localstack-docker-extension-preferences.png" title="Enable Docker Extensions in the Preferences within the Extensions tab" alt="Enable Docker Extensions in the Preferences within the Extensions tab" width="800px"   />
-<br></br>
+![Enable Docker Extensions in the Preferences within the Extensions tab](/images/aws/localstack-docker-extension-preferences.png)
 
 The LocalStack Extension for Docker Desktop has been validated and can be accessed on the Extensions Marketplace.
 To begin using it, navigate to the **Extensions Marketplace**, search for **LocalStack**, and click the **Install** button to proceed with the installation.
 
-<img src="localstack-docker-extension-marketplace.png" title="Discover the LocalStack Extension on the Docker Desktop Marketplace and install it!" width="800px" alt="Discover the LocalStack Extension on the Docker Desktop Marketplace and install it!" />
-<br></br>
+![Discover the LocalStack Extension on the Docker Desktop Marketplace and install it!](/images/aws/localstack-docker-extension-marketplace.png)
 
 An alternative method for installing the LocalStack's Extension for Docker Desktop is pulling the [public Docker image](https://hub.docker.com/r/localstack/localstack-docker-desktop) from Docker Hub and installing it!
 
-{{< command >}}
-$ docker extension install localstack/localstack-docker-desktop:0.5.3
-{{< /command >}}
+```bash
+docker extension install localstack/localstack-docker-desktop:0.5.3
+```
 
 After installation, you can access the LocalStack Extension for Docker Desktop from the **Extensions** tab.
 Upon the initial launch of the extension, a prompt to select a mount point for the LocalStack container will appear.
 Select your username from the drop-down menu.
 Furthermore, you can modify this setting later by navigating to the **Configurations** tab and choosing a different mount point.
 
+![](/images/aws/)
 <img src="localstack-docker-extension-mount-point.png" title="Select the mount point upon the launch of LocalStack's Docker extension" alt="Select the mount point upon the launch of LocalStack's Docker extension" width="800px"  />
 
 ## Features
@@ -50,19 +49,19 @@ The extension includes container management, configuration profile management, s
 You can start, stop, and restart LocalStack from the Docker Desktop.
 You can also see the current status of your LocalStack container and navigate to LocalStack Web Application.
 
-<img src="localstack-docker-extension-start.png" title="Start and Stop your LocalStack container with a single click of a button with LocalStack's extension" alt="Start and Stop your LocalStack container with a single click of a button with LocalStack's extension" width="800px"  />
+![Start and Stop your LocalStack container with a single click of a button with LocalStack's extension](/images/aws/localstack-docker-extension-start.png)
 
 ### Container logs
 
 You can see the log information of the LocalStack container and all the available services and their status on the service page.
 
-<img src="localstack-docker-extension-logs.png" title="Check the logs of your running LocalStack container through LocalStack's Docker extension" alt="Check the logs of your running LocalStack container through LocalStack's Docker extension" width="800px"  />
+![Check the logs of your running LocalStack container through LocalStack's Docker extension](/images/aws/localstack-docker-extension-logs.png)
 
 ### Configuration management
 
 You can manage and use your profiles via configurations and create new configurations for your LocalStack container.
 
-<img src="localstack-docker-extension-configuration-profile.png" title="Create your configuration profiles within LocalStack's Extension to affect the state of LocalStack" alt="Create your configuration profiles within LocalStack's Extension to affect the state of LocalStack" width="800px" />
+![Create your configuration profiles within LocalStack's Extension to affect the state of LocalStack](/images/aws/localstack-docker-extension-configuration-profile.png)
 
 ## Configure an Auth Token