Skip to content

Commit 35e8461

Browse files
skaggejVesaJuvonen
authored andcommitted
Spelling and grammar check (SharePoint#3362)
Pulled the contents of this into Word and ran a spelling and grammar check.
1 parent c1c7118 commit 35e8461

File tree

1 file changed

+12
-13
lines changed

1 file changed

+12
-13
lines changed

docs/spfx/toolchain/implement-ci-cd-with-azure-devops.md

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ localization_priority: Priority
1010

1111
Azure DevOps (Visual Studio Team Services / Team Foundation Server) consists of a set of tools and services that help developers implement DevOps, Continuous Integration, and Continuous Deployment processes for their development projects.
1212

13-
This article explains the steps involved in setting up your Azure DevOps environment with with Continuous Integration and Continuous Deployment to automate your SharePoint Framework builds, unit tests, and deployment.
13+
This article explains the steps involved in setting up your Azure DevOps environment with Continuous Integration and Continuous Deployment to automate your SharePoint Framework builds, unit tests, and deployment.
1414

1515
## Continuous Integration
1616

@@ -36,7 +36,7 @@ The Build Definition, as its name suggests, includes all the definitions and the
3636
3737
### Installing NodeJS version 8
3838

39-
Once the Build Definition has been created, the first thing you need to do is instal NodeJS. Make sure to install version 8, as SharePoint Framework depends on it.
39+
Once the Build Definition has been created, the first thing you need to do is install NodeJS. Make sure to install version 8, as SharePoint Framework depends on it.
4040
![installing node 8](../../images/azure-devops-spfx-02.png)
4141

4242
> [!NOTE]
@@ -49,7 +49,7 @@ Because third party dependencies are not stored in the source control, you need
4949

5050
### Executing Unit Tests
5151

52-
The SharePoint Framework supports writing units tests using KarmaJS, Mocha, Chai and Sinon. These modules are already referenced for you and it is highly recommended at a minimum to test the business logic of your code to get feedback on any potential issues or regressions as soon as possible. To have Azure DevOps execute your unit tests, add a `gulp` task. Set the path to the `gulpfile` file and set the `Gulp Tasks` option to `test`.
52+
The SharePoint Framework supports writing unit tests using KarmaJS, Mocha, Chai and Sinon. These modules are already referenced for you and it is highly recommended at a minimum to test the business logic of your code to get feedback on any potential issues or regressions as soon as possible. To have Azure DevOps execute your unit tests, add a `gulp` task. Set the path to the `gulpfile` file and set the `Gulp Tasks` option to `test`.
5353

5454
![executing unit tests](../../images/azure-devops-spfx-04.png)
5555

@@ -64,7 +64,7 @@ By default SharePoint Framework projects do not include a reporter for JUnit. Re
6464
6565
```
6666

67-
You also need to configure KarmaJS to load an use the reporter, to do so create a file `config/karma.config.js` and add the following content.
67+
You also need to configure KarmaJS to load and use the reporter, to do so create a file `config/karma.config.js` and add the following content.
6868

6969
```JS
7070
"use strict";
@@ -135,14 +135,13 @@ Add a `Copy Files` task and set the `Contents` to `**\*.sppkg` (the SharePoint P
135135

136136
### Publishing the artifacts
137137

138-
Now that you have collected all the files needed for deployment in a special artifacts folder, you still need to instruct Azure DevOps to keep these files after the execution of the build. To do so add a `Publis
139-
h artifacts` task and set the `Path to publish` to `$(build.artifactstagingdirectory)/drop` and the `Artifact name` to `drop`.
138+
Now that you have collected all the files needed for deployment in a special artifacts folder, you still need to instruct Azure DevOps to keep these files after the execution of the build. To do so add a `Publish artifacts` task and set the `Path to publish` to `$(build.artifactstagingdirectory)/drop` and the `Artifact name` to `drop`.
140139
![publishing the artifacts](../../images/azure-devops-spfx-09.png)
141140

142141

143142
## Continuous Deployment
144143

145-
Continuous Deployment (CD) takes validated code packages from build process and deploys them into a staging or production environment. Developers are able to track which deployments were successful or not and narrow down the issues to the particular package versions.
144+
Continuous Deployment (CD) takes validated code packages from build process and deploys them into a staging or production environment. Developers can track which deployments were successful or not and narrow down issues to specific package versions.
146145

147146
Setting up Azure DevOps for Continuous Deployments with a SharePoint Framework solution requires the following steps:
148147

@@ -158,7 +157,7 @@ Setting up Azure DevOps for Continuous Deployments with a SharePoint Framework s
158157

159158
### Creating the Release Definition
160159

161-
Start by creating a new Release Definition with an empty template. A Release Defition is a process that is used to identify the following elements for the deployment:
160+
Start by creating a new Release Definition with an empty template. A Release Definition is a process that is used to identify the following elements for the deployment:
162161

163162
- Environment
164163
- Deployment tasks
@@ -174,7 +173,7 @@ Click on `Add an artifact` and select the build definition you previously create
174173

175174
### Creating the Environment
176175

177-
When you create your continuous deployment environment, you can give a name and configure pre-deployment approvals, artificats filters (i.e. deploy only if the build comes from this or that branch), and much more by clicking on the buttons around the environment box or directly on the title.
176+
When you create your continuous deployment environment, you can give a name and configure pre-deployment approvals, artifact filters (i.e. deploy only if the build comes from this or that branch), and much more by clicking on the buttons around the environment box or directly on the title.
178177

179178
![creating the environment](../../images/azure-devops-spfx-12.png)
180179

@@ -195,7 +194,7 @@ The Office 365 Common Language Interface (CLI) is an open source project built b
195194
> Learn more about the [Office 365 CLI](https://pnp.github.io/office365-cli/)
196195
197196
### Connecting to the App Catalog
198-
Before using the App Catalog in you deployment environment, you first need to authenticate against the App Catalog of your tenant. To do so, add a `Command Line` task and paste in the following command into the `script` field `o365 spo login https://$(tenant).sharepoint.com/$(catalogsite) --authType password --userName $(username) --password $(password)
197+
Before using the App Catalog in your deployment environment, you first need to authenticate against the App Catalog of your tenant. To do so, add a `Command Line` task and paste in the following command into the `script` field `o365 spo login https://$(tenant).sharepoint.com/$(catalogsite) --authType password --userName $(username) --password $(password)
199198
`
200199
![connecting to the app catalog](../../images/azure-devops-spfx-15.png)
201200

@@ -213,7 +212,7 @@ Upload the solution package to your App Catalog by adding another `Command Line`
213212

214213
### Deploying the Application
215214

216-
The final step in the setup is to deploy the application to the App Catalog to make it available to all site collections within the tenant as it's latest version. Add another `Command Line` taks and paste the follwing command line in the `Script` field `o365 spo app deploy --name sp-fx-devops.sppkg --appCatalogUrl https://$(tenant).sharepoint.com/$(catalogsite)`
215+
The final step in the setup is to deploy the application to the App Catalog to make it available to all site collections within the tenant as its latest version. Add another `Command Line` task and paste the following command line in the `Script` field `o365 spo app deploy --name sp-fx-devops.sppkg --appCatalogUrl https://$(tenant).sharepoint.com/$(catalogsite)`
217216

218217
> [!NOTE]
219218
> Make sure you update the package name.
@@ -238,15 +237,15 @@ Add the following variables
238237
239238
## Testing
240239

241-
To test your newly created Continuous Deployment process, return to the `Builds` section in Azure DevOps, select your build definition and click on `Queue`. Select your branch, and click on `Queue`. A new build will be created and will start building.
240+
To test your newly created Continuous Deployment process, return to the `Builds` section in Azure DevOps, select your build definition and click on `Queue`. Select your branch and click on `Queue`. A new build will be created and will start building.
242241

243242
![Queuing a build](../../images/azure-devops-spfx-19.png)
244243

245244
After a couple of minutes, your build should complete and show a result page like this one.
246245

247246
![Results of a build](../../images/azure-devops-spfx-20.png)
248247

249-
If you navigate to the `Release` section of Azure DevOps, a new release should have started automatically. After a few minutes your release should complete and your SharePoint Framework solution is deployed to your tenant.
248+
If you navigate to the `Release` section of Azure DevOps, a new release should have started automatically. After a few minutes your release should complete, and your SharePoint Framework solution is deployed to your tenant.
250249

251250
![Results of a release](../../images/azure-devops-spfx-21.png)
252251

0 commit comments

Comments
 (0)