You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 10/umbraco-cms/extending/filesystemproviders/azure-blob-storage.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -44,7 +44,7 @@ The correct package will have be installed in your project.
44
44
45
45
## Configuring Blob storage
46
46
47
-
The next step is to configure your blob storage. There are multiple approaches for this, but in this document, we're going to do it through `appsettings.json`. For more configuration options, see the [readme](https://github.com/umbraco/Umbraco.StorageProviders#umbracostorageproviders) on the Github repository.
47
+
The next step is to configure your blob storage. There are multiple approaches for this, but in this document, we're going to do it through `appsettings.json`. For more configuration options, see the [readme](https://github.com/umbraco/Umbraco.StorageProviders#umbracostorageproviders) on the GitHub repository.
48
48
49
49
Open up your `appsettings.json` file and add the connection string and container name under `Umbraco:Storage:AzureBlob:Media`. Your Umbraco section of appsettings will look something like this:
| Version | 1.0.0 | This is automatically set to 1.0.0 but can be changed as appropriate. |
149
149
| Authors | Your name | Here you get to take credit for your awesome work! |
150
-
| PackageProjectUrl |https://umbraco.com| This URL will be shown as the package's URL when others install it. It will likely be a Github repository, or similar. |
150
+
| PackageProjectUrl |https://umbraco.com| This URL will be shown as the package's URL when others install it. It will likely be a GitHub repository, or similar. |
151
151
| PackageLicenseExpression | MIT | The license is set to MIT. Please consider how you want your package licensed. If in doubt when deciding an open-source license there are [good resources available](https://choosealicense.com/licenses/). |
Copy file name to clipboardExpand all lines: 10/umbraco-cms/extending/ui-library.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ You can also change the stylesheet of custom properties to see how the component
24
24
25
25
## Installing the UI Library Components
26
26
27
-
You can download the UI Library package from [Github](https://github.com/umbraco/Umbraco.UI/tree/v1/contrib/packages).
27
+
You can download the UI Library package from [GitHub](https://github.com/umbraco/Umbraco.UI/tree/v1/contrib/packages).
28
28
29
29
If you are installing a component via npm, there are two ways to import it:
30
30
@@ -40,7 +40,7 @@ If you are installing a component via npm, there are two ways to import it:
40
40
'@umbraco-ui/uui-button/lib/uui-button.element';
41
41
```
42
42
43
-
For more information on installation, Content Delivery Networks (CDN), or included components, see the [Readme file in the Github](https://github.com/umbraco/Umbraco.UI#readme) project.
43
+
For more information on installation, Content Delivery Networks (CDN), or included components, see the [Readme file in the GitHub](https://github.com/umbraco/Umbraco.UI#readme) project.
Copy file name to clipboardExpand all lines: 10/umbraco-cms/reference/security/cookies.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,4 +33,4 @@ services.AddSession(options =>
33
33
});
34
34
```
35
35
36
-
For information on the rest of the cookies, see the [Constants-Web.cs](https://github.com/umbraco/Umbraco-CMS/blob/v10/contrib/src/Umbraco.Core/Constants-Web.cs) file on Github.
36
+
For information on the rest of the cookies, see the [Constants-Web.cs](https://github.com/umbraco/Umbraco-CMS/blob/v10/contrib/src/Umbraco.Core/Constants-Web.cs) file on GitHub.
Copy file name to clipboardExpand all lines: 10/umbraco-cms/tutorials/creating-and-distributing-a-package.md
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,18 +12,18 @@ The content in this article is valid _only_ for Umbraco version 8. For Umbraco v
12
12
*[Creating a test site locally](creating-and-distributing-a-package.md#creating-a-test-site-locally)
13
13
*[Creating a package from the backoffice](creating-and-distributing-a-package.md#creating-a-package-from-the-backoffice)
14
14
*[Creating a draft package on Our](creating-and-distributing-a-package.md#creating-a-draft-package-on-our)
15
-
*[Pushing your package to Github](creating-and-distributing-a-package.md#pushing-your-package-to-github)
15
+
*[Pushing your package to GitHub](creating-and-distributing-a-package.md#pushing-your-package-to-github)
16
16
*[Pack up your package locally using UmbPack](creating-and-distributing-a-package.md#pack-up-your-package-locally-using-umbpack)
17
17
*[Pushing your package to Our using UmbPack](creating-and-distributing-a-package.md#pushing-your-package-to-our-using-umbpack)
18
-
*[Deploy your package using Github Actions](creating-and-distributing-a-package.md#deploy-your-package-using-github-actions)
18
+
*[Deploy your package using GitHub Actions](creating-and-distributing-a-package.md#deploy-your-package-using-github-actions)
19
19
*[Archive older versions on push](creating-and-distributing-a-package.md#archive-older-versions-on-push)
20
20
21
21
## Prerequisites
22
22
23
23
To run this tutorial you will need the following:
24
24
25
25
* Be able to run an Umbraco site locally
26
-
* Git + Github account
26
+
* Git + GitHub account
27
27
*[Our Umbraco member account](https://our.umbraco.com/member/Signup) with access to upload packages
28
28
* UmbPack installed
29
29
* Umbraco Package templates installed
@@ -60,7 +60,7 @@ It will show you all the options you have for creating a new Umbraco site + pack
60
60
dotnet new umbraco-v8-package -n PackageWorkshop -d
61
61
```
62
62
63
-
This will create a new package called `PackageWorkshop`, and add a custom Dashboard for us to use in this tutorial. By default you will also get a Github Action added that we will return to later.
63
+
This will create a new package called `PackageWorkshop`, and add a custom Dashboard for us to use in this tutorial. By default you will also get a GitHub Action added that we will return to later.
64
64
65
65
After running you will have a folder called `PackageWorkshop`, inside that you will have your site and solution files. So try to open it in Visual Studio or Rider by opening the `PackageWorkshop.sln` file.
66
66
@@ -234,13 +234,13 @@ Now your package is on Our, and if the "Go live" button is clicked it is visible
234
234
235
235
The next step is to make it a bit simpler to deploy updates to the package. It is perfectly fine to log in here and upload a new version each time. The next steps will show an easier way though.
236
236
237
-
## Pushing your package to Github
237
+
## Pushing your package to GitHub
238
238
239
239
If you are creating a package in order to share it with others it is a great idea to also share the source code. It is the open source way.
240
240
241
-
To share it, and make it easier to manage and deploy updates we will set up a Github repository for the package. This tutorial assumes you know what Github is, and that you have an account.
241
+
To share it, and make it easier to manage and deploy updates we will set up a GitHub repository for the package. This tutorial assumes you know what GitHub is, and that you have an account.
242
242
243
-
Create a fresh repo, with no readme, gitignore or license - do not choose a repository template (set to 'No Template'). On the second screen it will give you a command to push an existing repository to the new Github repo, should look like this but with your own user in the link:
243
+
Create a fresh repo, with no readme, gitignore or license - do not choose a repository template (set to 'No Template'). On the second screen it will give you a command to push an existing repository to the new GitHub repo, should look like this but with your own user in the link:
At this point you know how to create a package from the backoffice, upload it to Our and push your changes to Github. That's what it takes to create and maintain a package.
274
+
At this point you know how to create a package from the backoffice, upload it to Our and push your changes to GitHub. That's what it takes to create and maintain a package.
275
275
276
276
If you want to make changes and push a new version you can carry out the following steps:
277
277
278
278
* Create the new package in the backoffice
279
-
* Sync your code to Github
279
+
* Sync your code to GitHub
280
280
* Go to Our and upload a new zip version
281
281
* Set that to the current version
282
282
* Optionally archive the previous one
@@ -399,15 +399,15 @@ You can edit all of these defaults, and also specify older versions of your pack
399
399
400
400
So at this point we can work on our package locally, build a new version within seconds by running the pack command and then deploy it to Our using the push command.
401
401
402
-
Not easy enough for you? Let's try automating this entire thing with Github actions then.
402
+
Not easy enough for you? Let's try automating this entire thing with GitHub actions then.
403
403
404
-
## Deploy your package using Github Actions
404
+
## Deploy your package using GitHub Actions
405
405
406
-
If you think back to the beginning when we set up our sites using the Package Templates you may remember that by default you get a Github action installed as well.
406
+
If you think back to the beginning when we set up our sites using the Package Templates you may remember that by default you get a GitHub action installed as well.
407
407
408
408
If you check out the `~/.github/workflows` folder in your solution, you will see there is a readme file and a build.yml file.
409
409
410
-
The build.yml file is used by Github actions, which will perform some tasks for you when certain criteria are met. If you haven't worked with continuous integration and deployment (CI/CD) before, then this may seem like magic - but don't worry we will run through the commands.
410
+
The build.yml file is used by GitHub actions, which will perform some tasks for you when certain criteria are met. If you haven't worked with continuous integration and deployment (CI/CD) before, then this may seem like magic - but don't worry we will run through the commands.
411
411
412
412
The build.yml file contains several things, let's have a quick overview:
413
413
@@ -433,9 +433,9 @@ The action that it performs is what is under `jobs:build:steps`. There is a step
433
433
It sets the version of the package to be what we've set in the release tag based on a previous step.
434
434
{% endhint %}
435
435
436
-
Below this there is another step to push the package to Our, which again is like our approach locally - except now we add the API key as a Github secret so it's not public to everyone.
436
+
Below this there is another step to push the package to Our, which again is like our approach locally - except now we add the API key as a GitHub secret so it's not public to everyone.
437
437
438
-

438
+

439
439
440
440
```yml
441
441
- name: Push to Our
@@ -444,7 +444,7 @@ Below this there is another step to push the package to Our, which again is like
444
444
445
445
With these 2 commands and a few previous ones setting up the prerequisite build and nuget tools it is now ready to be fully automated.
446
446
447
-
Ensure you have set a Github secret with the name `UMBRACO_DEPLOY_KEY` and the value of the key from Our, and then go to your local solution and uncomment the UmbPack push command in the \~/.github/workflows/build.yml file.
447
+
Ensure you have set a GitHub secret with the name `UMBRACO_DEPLOY_KEY` and the value of the key from Our, and then go to your local solution and uncomment the UmbPack push command in the \~/.github/workflows/build.yml file.
Your solution and Github repo are now in sync, and the umbpack commands in the Github action are enabled and ready to run. Final step is to create a release tag and push it to Github:
457
+
Your solution and GitHub repo are now in sync, and the umbpack commands in the GitHub action are enabled and ready to run. Final step is to create a release tag and push it to GitHub:
458
458
459
459
```none
460
460
git tag release/1.0.0
461
461
git push origin release/1.0.0
462
462
```
463
463
464
-
At this point you can go to Github and visit the Action tab to see your Github action run. When it's completed successfully you can go to your package overview on Our and see the package there.
464
+
At this point you can go to GitHub and visit the Action tab to see your GitHub action run. When it's completed successfully you can go to your package overview on Our and see the package there.
Copy file name to clipboardExpand all lines: 10/umbraco-commerce/upgrading/version-specific-upgrades.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,4 +20,4 @@ See the [Migrate from Vendr to Umbraco Commerce guide](../upgrading/migrate-from
20
20
21
21
## Legacy version specific upgrade notes
22
22
23
-
You can find the version specific upgrade notes for versions out of support in the [Legacy documentation on Github](https://github.com/umbraco/UmbracoDocs/tree/umbraco-eol-versions). 
23
+
You can find the version specific upgrade notes for versions out of support in the [Legacy documentation on GitHub](https://github.com/umbraco/UmbracoDocs/tree/umbraco-eol-versions). 
Copy file name to clipboardExpand all lines: 10/umbraco-deploy/deployment-workflow/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,7 @@ Umbraco Deploy uses a two-part deployment approach where we keep meta data (Docu
19
19
20
20
In summary:
21
21
22
-
1. Meta data such as Document Types, Templates, Forms, Views and config files are stored in a repository and are **deployed** between environments. This can be achieved using a CI/CD deployment pipeline with something like Github Actions or Azure DevOps.
22
+
1. Meta data such as Document Types, Templates, Forms, Views and config files are stored in a repository and are **deployed** between environments. This can be achieved using a CI/CD deployment pipeline with something like GitHub Actions or Azure DevOps.
23
23
2. Content and Media items are **not** stored in the repository. These need to be **transferred** directly from the Umbraco backoffice using the _"Queue for Transfer"_ option. Once a content editor has all the items needed for a transfer they will use the Deployment Dashboard in the Content section to transfer the items in the queue.
Copy file name to clipboardExpand all lines: 10/umbraco-deploy/getting-started/cicd-pipeline/README.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ The build server will extract the changes that has been pushed to the repository
10
10
11
11
This is something that can be done in many different ways depending on where your website is hosted and your setup.
12
12
13
-
Umbraco Deploy does not require the use of any particular build or deployment tools and hence we expect that you should be able to continue using the tool or tools of your choice. Any that have support for .NET website deployments and the running of Powershell scripts. such as Azure DevOps or Github Actions, would be appropriate.
13
+
Umbraco Deploy does not require the use of any particular build or deployment tools and hence we expect that you should be able to continue using the tool or tools of your choice. Any that have support for .NET website deployments and the running of Powershell scripts. such as Azure DevOps or GitHub Actions, would be appropriate.
14
14
15
15
Above and beyond the normal steps of a build pipeline for a .NET web application - tasks like NuGet restore, solution build, running of tests etc. - Umbraco Deploy requires three additional steps.
16
16
@@ -34,9 +34,9 @@ Umbraco Deploy On-Premises also ships with a Powershell script, that when execut
34
34
35
35
So while it may be possible to have the CI/CD step directly write the file or call the endpoint, so long as the build used supports running Powershell scripts this is the method we’d recommend, as it has some necessary error checking and retry logic built-in.
36
36
37
-
## [Setting up CI/CD pipeline with Github Actions](ci-cd-github-actions.md)
37
+
## [Setting up CI/CD pipeline with GitHub Actions](ci-cd-github-actions.md)
38
38
39
-
Details the setup of a CI/CD pipeline using Github Actions.
39
+
Details the setup of a CI/CD pipeline using GitHub Actions.
40
40
41
41
## [Setting up CI/CD pipeline with Azure DevOps](ci-cd-azure-dev-ops.md)
0 commit comments