diff --git a/content/manuals/compose/bridge/_index.md b/content/manuals/compose/bridge/_index.md index b84dcb8dba6..37bf983320a 100644 --- a/content/manuals/compose/bridge/_index.md +++ b/content/manuals/compose/bridge/_index.md @@ -30,8 +30,8 @@ To get started with Compose Bridge, you need to: 1. Download and install Docker Desktop version 4.33 and later. 2. Sign in to your Docker account. -3. Navigate to the **Features in development** tab in **Settings**. -4. From the **Experimental features** tab, select **Enable Compose Bridge**. +3. Navigate to the **Beta features** tab in **Settings**. +4. Select **Enable Compose Bridge**. 5. Select **Apply & restart**. ## Feedback @@ -41,5 +41,4 @@ To give feedback, report bugs, or receive support, email `desktop-preview@docker ## What's next? - [Use Compose Bridge](usage.md) -- [Explore how you can customize Compose Bridge](customize.md) -- [Explore the advanced integration](advanced-integration.md) +- [Explore how you can customize Compose Bridge](customize.md) \ No newline at end of file diff --git a/content/manuals/compose/bridge/advanced-integration.md b/content/manuals/compose/bridge/advanced-integration.md deleted file mode 100644 index db9e7183754..00000000000 --- a/content/manuals/compose/bridge/advanced-integration.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Advanced integration -linkTitle: Advanced -weight: 30 -description: Learn about how Compose Bridge can function a kubectl plugin -keywords: kubernetes, compose, compose bridge, plugin, advanced ---- - -{{< summary-bar feature_name="Compose bridge" >}} - -Compose Bridge can also function as a `kubectl` plugin, allowing you to integrate its capabilities directly into your Kubernetes command-line operations. This integration simplifies the process of converting and deploying applications from Docker Compose to Kubernetes. - -## Use `compose-bridge` as a `kubectl` plugin - -To use the `compose-bridge` binary as a `kubectl` plugin, you need to make sure that the binary is available in your PATH and the name of the binary is prefixed with `kubectl-`. - -1. Rename or copy the `compose-bridge` binary to `kubectl-compose_bridge`: - - ```console - $ mv /path/to/compose-bridge /usr/local/bin/kubectl-compose_bridge - ``` - -2. Ensure that the binary is executable: - - ```console - $ chmod +x /usr/local/bin/kubectl-compose_bridge - ``` - -3. Verify that the plugin is recognized by `kubectl`: - - ```console - $ kubectl plugin list - ``` - - In the output, you should see `kubectl-compose_bridge`. - -4. Now you can use `compose-bridge` as a `kubectl` plugin: - - ```console - $ kubectl compose-bridge [command] - ``` - -Replace `[command]` with any `compose-bridge` command you want to use. diff --git a/content/manuals/compose/bridge/customize.md b/content/manuals/compose/bridge/customize.md index d978ecf6b9f..39071005342 100644 --- a/content/manuals/compose/bridge/customize.md +++ b/content/manuals/compose/bridge/customize.md @@ -91,7 +91,7 @@ decisions and preferences, with various level of flexibility and effort. ### Modify the default templates You can extract templates used by the default transformation `docker/compose-bridge-kubernetes`, -by running `compose-bridge transformations create --from docker/compose-bridge-kubernetes my-template` +by running `docker compose bridge transformations create --from docker/compose-bridge-kubernetes my-template` and adjusting the templates to match your needs. The templates are extracted into a directory named after your template name, in this case `my-template`. @@ -106,7 +106,7 @@ $ docker build --tag mycompany/transform --push . You can then use your transformation as a replacement: ```console -$ compose-bridge convert --transformations mycompany/transform +$ docker compose bridge convert --transformations mycompany/transform ``` ### Add your own templates @@ -152,7 +152,7 @@ when transforming Compose models into Kubernetes in addition to other transformations: ```console -$ compose-bridge convert \ +$ docker compose bridge convert \ --transformation docker/compose-bridge-kubernetes \ --transformation mycompany/transform ``` @@ -184,7 +184,3 @@ CMD ["/usr/bin/kompose", "convert", "-f", "/in/compose.yaml", "--out", "/out"] This Dockerfile bundles Kompose and defines the command to run this tool according to the Compose Bridge transformation contract. - -## What's next? - -- [Explore the advanced integration](advanced-integration.md) diff --git a/content/manuals/compose/bridge/usage.md b/content/manuals/compose/bridge/usage.md index 091457fbeef..47c418eff06 100644 --- a/content/manuals/compose/bridge/usage.md +++ b/content/manuals/compose/bridge/usage.md @@ -29,14 +29,14 @@ It also supplies a Kustomize overlay dedicated to Docker Desktop with: To use the default transformation run the following command: ```console -$ compose-bridge convert +$ docker compose bridge convert ``` Compose looks for a `compose.yaml` file inside the current directory and then converts it. The following output is displayed ```console -$ compose-bridge convert -f compose.yaml +$ docker compose bridge convert -f compose.yaml Kubernetes resource api-deployment.yaml created Kubernetes resource db-deployment.yaml created Kubernetes resource web-deployment.yaml created @@ -69,13 +69,13 @@ the standard deployment command `kubectl apply -k out/overlays/desktop/`. If you want to convert a `compose.yaml` file that is located in another directory, you can run: ```console -$ compose-bridge convert -f /compose.yaml +$ docker compose bridge convert -f /compose.yaml ``` To see all available flags, run: ```console -$ compose-bridge convert --help +$ docker compose bridge convert --help ``` > [!TIP] @@ -86,5 +86,4 @@ $ compose-bridge convert --help ## What's next? -- [Explore how you can customize Compose Bridge](customize.md) -- [Explore the advanced integration](advanced-integration.md) +- [Explore how you can customize Compose Bridge](customize.md) \ No newline at end of file diff --git a/content/reference/cli/docker/compose/bridge/_index.md b/content/reference/cli/docker/compose/bridge/_index.md new file mode 100644 index 00000000000..a076d5f7d30 --- /dev/null +++ b/content/reference/cli/docker/compose/bridge/_index.md @@ -0,0 +1,13 @@ +--- +datafolder: compose-cli +datafile: docker_compose_bridge +title: docker compose bridge +layout: cli +--- + + \ No newline at end of file diff --git a/content/reference/cli/docker/compose/bridge/convert.md b/content/reference/cli/docker/compose/bridge/convert.md new file mode 100644 index 00000000000..c8310f0c0d7 --- /dev/null +++ b/content/reference/cli/docker/compose/bridge/convert.md @@ -0,0 +1,13 @@ +--- +datafolder: compose-cli +datafile: docker_compose_bridge_convert +title: docker compose bridge convert +layout: cli +--- + + \ No newline at end of file diff --git a/content/reference/cli/docker/compose/bridge/transformations/_index.md b/content/reference/cli/docker/compose/bridge/transformations/_index.md new file mode 100644 index 00000000000..d7e61d411c9 --- /dev/null +++ b/content/reference/cli/docker/compose/bridge/transformations/_index.md @@ -0,0 +1,13 @@ +--- +datafolder: compose-cli +datafile: docker_compose_bridge_transformations +title: docker compose bridge transformations +layout: cli +--- + + \ No newline at end of file diff --git a/content/reference/cli/docker/compose/bridge/transformations/create.md b/content/reference/cli/docker/compose/bridge/transformations/create.md new file mode 100644 index 00000000000..efc0801f27e --- /dev/null +++ b/content/reference/cli/docker/compose/bridge/transformations/create.md @@ -0,0 +1,13 @@ +--- +datafolder: compose-cli +datafile: docker_compose_bridge_transformations_create +title: docker compose bridge transformations create +layout: cli +--- + + \ No newline at end of file diff --git a/content/reference/cli/docker/compose/bridge/transformations/list.md b/content/reference/cli/docker/compose/bridge/transformations/list.md new file mode 100644 index 00000000000..5af7198a69a --- /dev/null +++ b/content/reference/cli/docker/compose/bridge/transformations/list.md @@ -0,0 +1,13 @@ +--- +datafolder: compose-cli +datafile: docker_compose_bridge_transformations_list +title: docker compose bridge transformations list +layout: cli +--- + + \ No newline at end of file