diff --git a/docusaurus/docs/cloud/getting-started/deployment.md b/docusaurus/docs/cloud/getting-started/deployment.md index cd43417956..bd1cd35053 100644 --- a/docusaurus/docs/cloud/getting-started/deployment.md +++ b/docusaurus/docs/cloud/getting-started/deployment.md @@ -23,7 +23,7 @@ Before you can deploy your Strapi application on Strapi Cloud using the Cloud da * Strapi version `4.8.2` or higher * Project database must be compatible with PostgreSQL. Strapi does not support and does not recommend using any external databases, though it's possible to configure one (see [advanced database configuration](/cloud/advanced/database)). -* Project(s) source code hosted on or . The connected repository can contain multiple Strapi applications. Each Strapi app must be in a separate directory. +* Project source code hosted on or . The connected repository can contain multiple Strapi applications. Each Strapi app must be in a separate directory. * Specifically for GitLab: at least have "" permissions for the project to import on Strapi Cloud. ::: @@ -41,7 +41,7 @@ Before you can deploy your Strapi application on Strapi Cloud using the Cloud da }} /> -## Deploying a project +## Creating a project {#deploying-a-project} 1. From the *Projects* page, click the **Create project** button. @@ -53,7 +53,7 @@ Before you can deploy your Strapi application on Strapi Cloud using the Cloud da }} /> -2. You will be redirected to the first project deployment interface. This interface contains 3 steps: choosing a plan, connecting a remote git repository, and setting up the project. +2. You will be redirected to the project creation interface. This interface contains 3 steps: choosing a plan, connecting a remote git repository, and setting up the project. Skip to step 5 of the section below to finalise the creation of your project. + Skip to step 5 of the section below to finalize the creation of your project. ::: 1. Click on the **Continue to billing** button. You will directly be redirected to the second and final project deployment interface. There you can review all your new project setup information, enter payment & billing details and receive your invoice. @@ -195,18 +195,35 @@ To upgrade your project to a paid plan, you will need to fill in your billing in }} /> -2. Review your project: make sure the plan and setup information are correct. If needed, click the **Edit** button to be redirected to the first interface of the project creation and fix any mistake. +2. Review your project: make sure the plan and setup information are correct. If needed, click the **Edit** button to navigate back to the first step of the project creation and fix any mistake. 3. In the Payment section, fill in at least all mandatory elements for *Payment method* and *Billing information*. 4. Check your invoice which informs you of what should be paid now and the following month. Optionally, you can enter a *Discount code* if you have one. -5. Click on the **Create project** button to finalize the deployment of your new Strapi Cloud project. An initial deployment will automatically be triggered and you will be redirected to the *Projects* page. +5. Click on the **Create project** button to finalize the creation of your new Strapi Cloud project. -:::caution -Create your Admin user after the initial deployment is complete. Do not share your application URL with anyone until you have created your Admin user. +## Deploying your project + +After confirming the project creation, you will be redirected to your *Project dashboard* where you will be able to follow its creation and first deployment. + +While your project is deploying, you can already start configuring some of your [project settings](/cloud/projects/settings). + + + +:::note +If an error occurs during the project creation, the progress indicator will stop and display an error message. You will see a **Retry** button next to the failed step, allowing you to restart the creation process. ::: +Once you project is successfully deployed, the creation tracker will be replaced by your deployments list and you will be able to visit your Cloud hosted project. Don't forget to create the first Admin user before sharing your Strapi project. + + ## What to do next? Now that you have deployed your project via the Cloud dashboard, we encourage you to explore the following ideas to have an even more complete Strapi Cloud experience: diff --git a/docusaurus/docs/cloud/projects/settings.md b/docusaurus/docs/cloud/projects/settings.md index 29bea264bb..aa8b20c4b1 100644 --- a/docusaurus/docs/cloud/projects/settings.md +++ b/docusaurus/docs/cloud/projects/settings.md @@ -143,12 +143,12 @@ To create a new environment: | Git branch | (mandatory) Select the right branch for your new environment. | | Base directory | Write the name of the base directory of your new environment. | | Import variables | Tick the box to import variable names from an existing environment. Values will not be imported, and all variables will remain blank. | - | Auto-deploy | Tick the box to automatically trigger a new deployment whenever a new commit is pushed to the selected branch. Untick it to disable the option. | + | Deploy on push | Tick this box to automatically trigger a deployment when changes are pushed to your selected branch. When disabled, you will need to manually deploy the latest changes. | -4. Click on the **Add environment** button to create your project's new environment. A new deployment will automatically be triggered. +4. Click on the **Add environment** button to create your project's new environment. You will then be redirected to your *Project dashboard* where you will be able to follow your new environment's creation and first deployment. -:::caution -If the creation of a new environment fails but you are still charged, try creating the environment again. This time, the environment creation should be successful and you will not be charged a second time. This behaviour is an known issue that should be fixed in the upcoming weeks. +:::note +If an error occurs during the environment creation, the progress indicator will stop and display an error message. You will see a **Retry** button next to the failed step, allowing you to restart the creation process. ::: ### Billing & Usage diff --git a/docusaurus/static/img/assets/cloud/account-repo-selection.png b/docusaurus/static/img/assets/cloud/account-repo-selection.png index 31057af0e6..c477c97054 100644 Binary files a/docusaurus/static/img/assets/cloud/account-repo-selection.png and b/docusaurus/static/img/assets/cloud/account-repo-selection.png differ diff --git a/docusaurus/static/img/assets/cloud/account-repo-selection_DARK.png b/docusaurus/static/img/assets/cloud/account-repo-selection_DARK.png index 1277d11de2..12b204981c 100644 Binary files a/docusaurus/static/img/assets/cloud/account-repo-selection_DARK.png and b/docusaurus/static/img/assets/cloud/account-repo-selection_DARK.png differ diff --git a/docusaurus/static/img/assets/cloud/environments.png b/docusaurus/static/img/assets/cloud/environments.png index f6ad58c661..54e157cfa0 100644 Binary files a/docusaurus/static/img/assets/cloud/environments.png and b/docusaurus/static/img/assets/cloud/environments.png differ diff --git a/docusaurus/static/img/assets/cloud/environments_DARK.png b/docusaurus/static/img/assets/cloud/environments_DARK.png index b9298c1d18..30f42cb751 100644 Binary files a/docusaurus/static/img/assets/cloud/environments_DARK.png and b/docusaurus/static/img/assets/cloud/environments_DARK.png differ diff --git a/docusaurus/static/img/assets/cloud/project-creation-3.png b/docusaurus/static/img/assets/cloud/project-creation-3.png new file mode 100644 index 0000000000..9a24d71442 Binary files /dev/null and b/docusaurus/static/img/assets/cloud/project-creation-3.png differ diff --git a/docusaurus/static/img/assets/cloud/project-creation-3_DARK.png b/docusaurus/static/img/assets/cloud/project-creation-3_DARK.png new file mode 100644 index 0000000000..99d2c77a10 Binary files /dev/null and b/docusaurus/static/img/assets/cloud/project-creation-3_DARK.png differ