mirror of
https://github.com/facebook/docusaurus.git
synced 2025-08-06 10:20:09 +02:00
docs(v2):Add azure-pipelines CI guide (#3101)
Closes https://github.com/facebook/docusaurus/issues/1208
This commit is contained in:
parent
298522ff66
commit
0f8a64428c
1 changed files with 36 additions and 0 deletions
|
@ -217,6 +217,42 @@ script:
|
||||||
|
|
||||||
Now, whenever a new commit lands in `master`, Travis CI will run your suite of tests and if everything passes, your website will be deployed via the `yarn deploy` script.
|
Now, whenever a new commit lands in `master`, Travis CI will run your suite of tests and if everything passes, your website will be deployed via the `yarn deploy` script.
|
||||||
|
|
||||||
|
### Using Azure Pipelines
|
||||||
|
|
||||||
|
1. Sign Up at [Azure Pipelines](https://azure.microsoft.com/en-us/services/devops/pipelines/) if you haven't already.
|
||||||
|
1. Create an organization and within the organization create a project and connect your repository from GitHub.
|
||||||
|
1. Go to https://github.com/settings/tokens and generate a new [personal access token](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/) with repository scope.
|
||||||
|
1. In the project page (which looks like https://dev.azure.com/ORG_NAME/REPO_NAME/_build) create a new pipeline with the following text. Also, click on edit and add a new environment variable named `GH_TOKEN` with your newly generated token as its value, then `GH_EMAIL` (your email address) and `GH_NAME` (your GitHub username). Make sure to mark them as secret. Alternatively, you can also add a file named `azure-pipelines.yml` at yout repository root.
|
||||||
|
|
||||||
|
```yaml title="azure-pipelines.yml"
|
||||||
|
trigger:
|
||||||
|
- master
|
||||||
|
|
||||||
|
pool:
|
||||||
|
vmImage: 'ubuntu-latest'
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- checkout: self
|
||||||
|
persistCredentials: true
|
||||||
|
|
||||||
|
- task: NodeTool@0
|
||||||
|
inputs:
|
||||||
|
versionSpec: '10.x'
|
||||||
|
displayName: 'Install Node.js'
|
||||||
|
|
||||||
|
- script: |
|
||||||
|
git config --global user.name "${GH_NAME}"
|
||||||
|
git config --global user.email "${GH_EMAIL}"
|
||||||
|
git checkout -b master
|
||||||
|
echo "machine github.com login ${GH_NAME} password ${GH_TOKEN}" > ~/.netrc
|
||||||
|
yarn && GIT_USER="${GH_NAME}" yarn deploy
|
||||||
|
env:
|
||||||
|
GH_NAME: $(GH_NAME)
|
||||||
|
GH_EMAIL: $(GH_EMAIL)
|
||||||
|
GH_TOKEN: $(GH_TOKEN)
|
||||||
|
displayName: 'yarn install and build'
|
||||||
|
```
|
||||||
|
|
||||||
## Deploying to Netlify
|
## Deploying to Netlify
|
||||||
|
|
||||||
To deploy your Docusaurus 2 sites to [Netlify](https://www.netlify.com/), first make sure the following options are properly configured:
|
To deploy your Docusaurus 2 sites to [Netlify](https://www.netlify.com/), first make sure the following options are properly configured:
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue