From 849aeffa537d053145cdc69c3147d85935096dba Mon Sep 17 00:00:00 2001 From: Jesper Madsen Date: Thu, 22 May 2025 11:11:16 +0200 Subject: [PATCH 1/5] Rename samples to reflect api version used --- .../umbraco-cicd/samplecicdpipeline/README.md | 4 ++-- .../{azure-devops.md => v1-azure-devops.md} | 0 .../{github-actions.md => v1-github-actions.md} | 0 3 files changed, 2 insertions(+), 2 deletions(-) rename umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/{azure-devops.md => v1-azure-devops.md} (100%) rename umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/{github-actions.md => v1-github-actions.md} (100%) diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md index 669ba33ea6f..2fb43dc72d8 100644 --- a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md +++ b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md @@ -76,10 +76,10 @@ During the guides, you will have the option to choose between Powershell or Bash Details the setup of a CI/CD pipeline using Azure DevOps. -* [Azure DevOps Sample](azure-devops.md) +* [Azure DevOps Sample](v1-azure-devops.md) ### GitHub Actions sample Details the setup of a CI/CD pipeline using GitHub Actions. -* [GitHub Actions Sample](github-actions.md) +* [GitHub Actions Sample](v1-github-actions.md) diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/azure-devops.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-azure-devops.md similarity index 100% rename from umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/azure-devops.md rename to umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-azure-devops.md diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/github-actions.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-github-actions.md similarity index 100% rename from umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/github-actions.md rename to umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-github-actions.md From 0387b269dab4c94f6c221f517b2b94a9b027ba4c Mon Sep 17 00:00:00 2001 From: Jesper Madsen Date: Thu, 22 May 2025 11:43:16 +0200 Subject: [PATCH 2/5] mention apply patch pwsh/sh script in samples --- .../umbraco-cicd/samplecicdpipeline/README.md | 4 ++-- .../umbraco-cicd/samplecicdpipeline/v1-azure-devops.md | 2 ++ .../umbraco-cicd/samplecicdpipeline/v1-github-actions.md | 2 ++ 3 files changed, 6 insertions(+), 2 deletions(-) diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md index 2fb43dc72d8..a27e0498864 100644 --- a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md +++ b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md @@ -74,12 +74,12 @@ During the guides, you will have the option to choose between Powershell or Bash ### Azure DevOps sample -Details the setup of a CI/CD pipeline using Azure DevOps. +Details the setup of a CI/CD pipeline using Azure DevOps with the v1 cloud api endpoints. * [Azure DevOps Sample](v1-azure-devops.md) ### GitHub Actions sample -Details the setup of a CI/CD pipeline using GitHub Actions. +Details the setup of a CI/CD pipeline using GitHub Actions with the v1 cloud api endpoints. * [GitHub Actions Sample](v1-github-actions.md) diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-azure-devops.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-azure-devops.md index 3e9ab961687..2bdd89fd62a 100644 --- a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-azure-devops.md +++ b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-azure-devops.md @@ -77,6 +77,7 @@ For a pipeline that uses Powershell scripts you will need the following files: * From the `powershell` folder * `Get-LatestDeployment.ps1` * `Get-ChangesById.ps1` + * `Apply-Patch.ps1` * `New-Deployment.ps1` * `Add-DeploymentPackage.ps1` * `Start-Deployment.ps1` @@ -108,6 +109,7 @@ For a pipeline that uses Bash scripts you will need the following files: * From the `bash` folder * `get_latest_deployment.sh` * `get_changes_by_id.sh` + * `apply-patch.sh` * `create_deployment.sh` * `upload_package.sh` * `start_deployment.sh` diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-github-actions.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-github-actions.md index e47fcd9bcdf..70313b96068 100644 --- a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-github-actions.md +++ b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-github-actions.md @@ -127,6 +127,7 @@ For a pipeline that uses Powershell scripts you will need the following files: * From the `powershell` folder * `Get-LatestDeployment.ps1` * `Get-ChangesById.ps1` + * `Apply-Patch.ps1` * `New-Deployment.ps1` * `Add-DeploymentPackage.ps1` * `Start-Deployment.ps1` @@ -160,6 +161,7 @@ For a pipeline that uses Bash scripts you will need the following files: * From the `bash` folder * `get_latest_deployment.sh` * `get_changes_by_id.sh` + * `apply-patch.sh` * `create_deployment.sh` * `upload_package.sh` * `start_deployment.sh` From 5e3d873a9b96e3668d473563d221112ad5da2156 Mon Sep 17 00:00:00 2001 From: Jesper Madsen <32263802+jesp209i@users.noreply.github.com> Date: Mon, 26 May 2025 10:21:10 +0200 Subject: [PATCH 3/5] Remove old text --- .../umbraco-cicd/KnownLimitationsAndConsiderations.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/KnownLimitationsAndConsiderations.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/KnownLimitationsAndConsiderations.md index 33115e9f92e..431e6a1d4af 100644 --- a/umbraco-cloud/set-up/project-settings/umbraco-cicd/KnownLimitationsAndConsiderations.md +++ b/umbraco-cloud/set-up/project-settings/umbraco-cicd/KnownLimitationsAndConsiderations.md @@ -29,11 +29,9 @@ Attaching a CI/CD pipeline to a flexible environment is currently not possible. * **Direct Commits to Umbraco Git Repos**: Any commits made directly to the Umbraco-git-repos will cause the process to fail. * **Remote Build/Test Options**: It is currently not possible to skip the first build step before committing. * **Incomplete API**: - * The list endpoint lacks filtering capabilities. * The promotion endpoint for transitioning from dev to stage to live is not fully functional yet. * **Hotfix Deployments**: Direct deployments to a specific environment are not supported at this time. * **Lack of Predefined Tasks**: There are no Umbraco-provided Azure DevOps tasks or GitHub Actions available. * **No Webhooks**: Currently, there's no webhook support for real-time feedback to the pipeline; polling is the only option. * **Casing Conflicts**: Be cautious of casing issues, such as having a README.md file created by Azure DevOps and a `Readme.md` file from the default Umbraco Cloud, as this can cause conflicts in the cloud Git repository. -* **Documentation Alignment**: We are in the process of updating our documentation to align with standard Umbraco guidelines. -* **Developer Experience**: Plans are underway to create Umbraco-specific Azure DevOps tasks and GitHub Actions to enhance the developer experience. + From c023ab16e60efc8460150dd1d40c8e45e2b41f72 Mon Sep 17 00:00:00 2001 From: Jesper Madsen Date: Wed, 28 May 2025 14:21:24 +0200 Subject: [PATCH 4/5] rewind --- .../umbraco-cicd/samplecicdpipeline/README.md | 8 ++++---- .../{v1-azure-devops.md => azure-devops.md} | 0 .../{v1-github-actions.md => github-actions.md} | 0 3 files changed, 4 insertions(+), 4 deletions(-) rename umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/{v1-azure-devops.md => azure-devops.md} (100%) rename umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/{v1-github-actions.md => github-actions.md} (100%) diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md index a27e0498864..669ba33ea6f 100644 --- a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md +++ b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/README.md @@ -74,12 +74,12 @@ During the guides, you will have the option to choose between Powershell or Bash ### Azure DevOps sample -Details the setup of a CI/CD pipeline using Azure DevOps with the v1 cloud api endpoints. +Details the setup of a CI/CD pipeline using Azure DevOps. -* [Azure DevOps Sample](v1-azure-devops.md) +* [Azure DevOps Sample](azure-devops.md) ### GitHub Actions sample -Details the setup of a CI/CD pipeline using GitHub Actions with the v1 cloud api endpoints. +Details the setup of a CI/CD pipeline using GitHub Actions. -* [GitHub Actions Sample](v1-github-actions.md) +* [GitHub Actions Sample](github-actions.md) diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-azure-devops.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/azure-devops.md similarity index 100% rename from umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-azure-devops.md rename to umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/azure-devops.md diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-github-actions.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/github-actions.md similarity index 100% rename from umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/v1-github-actions.md rename to umbraco-cloud/set-up/project-settings/umbraco-cicd/samplecicdpipeline/github-actions.md From db7b62d139d6d54771be50a73bab31474947d911 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Wed, 28 May 2025 19:57:44 +0200 Subject: [PATCH 5/5] Small change to trigger GitBook checks --- .../umbraco-cicd/KnownLimitationsAndConsiderations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-cloud/set-up/project-settings/umbraco-cicd/KnownLimitationsAndConsiderations.md b/umbraco-cloud/set-up/project-settings/umbraco-cicd/KnownLimitationsAndConsiderations.md index 431e6a1d4af..dde312f5f30 100644 --- a/umbraco-cloud/set-up/project-settings/umbraco-cicd/KnownLimitationsAndConsiderations.md +++ b/umbraco-cloud/set-up/project-settings/umbraco-cicd/KnownLimitationsAndConsiderations.md @@ -29,7 +29,7 @@ Attaching a CI/CD pipeline to a flexible environment is currently not possible. * **Direct Commits to Umbraco Git Repos**: Any commits made directly to the Umbraco-git-repos will cause the process to fail. * **Remote Build/Test Options**: It is currently not possible to skip the first build step before committing. * **Incomplete API**: - * The promotion endpoint for transitioning from dev to stage to live is not fully functional yet. + * The promotion endpoint for transitioning between environments is not fully functional yet. * **Hotfix Deployments**: Direct deployments to a specific environment are not supported at this time. * **Lack of Predefined Tasks**: There are no Umbraco-provided Azure DevOps tasks or GitHub Actions available. * **No Webhooks**: Currently, there's no webhook support for real-time feedback to the pipeline; polling is the only option.