Skip to content

feat: add docs for app cloning#2116

Open
Christos Vontas (cv711) wants to merge 15 commits intomainfrom
feat/app-cloning-docs
Open

feat: add docs for app cloning#2116
Christos Vontas (cv711) wants to merge 15 commits intomainfrom
feat/app-cloning-docs

Conversation

@cv711

No description provided.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new Shopware PaaS Native guide that documents how to clone an application (interactive and manual CLI usage), including prerequisites, what cloning does under the hood, and post-clone follow-ups.

Changes:

  • Added a new “Clone Application” guide with step-by-step CLI instructions.
  • Documented prerequisites, clone stages (snapshot create/restore), and progress monitoring commands.
  • Listed recommended post-clone tasks (config, domains, secrets, validation).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@JoshuaBehrens
Copy link
Contributor

Can we somehow not use the name app or make sure the search is more context aware? I assume the docs search does not find it easy to distinguish app as in extension system and app in paas.

@cv711
Copy link
Author

Joshua Behrens (@JoshuaBehrens) unfortunately we call it application in the backend, so that can not change. In the docs I'm using only app for one of the examples for brevity, if the issue is just with the word itself it's very localised. As for the docs search I don't have any more info to help with that one.

@renaudhager
Copy link
Member

Micha Hobert (@Isengo1989) can we merge this?


This guide explains how to clone an application in Shopware PaaS Native. Cloning creates a copy of an existing application, including its codebase and data, to a new application within the same organization.

**Important**: Cloning can only take place between applications within the same organization. You cannot clone applications across different organizations.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**Important**: Cloning can only take place between applications within the same organization. You cannot clone applications across different organizations.
:::info
Cloning can only take place between applications within the same organization. You cannot clone applications across different organizations.
:::

sw-paas app deploy list
```

If the state is `DEPLOYING_STORE_FAILED`, you should **NOT** proceed with cloning. Fix the deployment issues first or proceed with an earlier deployment that was successful.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If the state is `DEPLOYING_STORE_FAILED`, you should **NOT** proceed with cloning. Fix the deployment issues first or proceed with an earlier deployment that was successful.
:::warning
If the state is `DEPLOYING_STORE_FAILED`, you should **NOT** proceed with cloning. Fix the deployment issues first or proceed with an earlier deployment that was successful.
:::


If the state is `DEPLOYING_STORE_FAILED`, you should **NOT** proceed with cloning. Fix the deployment issues first or proceed with an earlier deployment that was successful.

## Clone Process
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Clone Process
## Clone an application
You can clone an application using either interactive mode or manual mode

--target-project-id <target-project-id>
```

### How Cloning Works
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### How Cloning Works
## Clone process

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

Comments