Azure의 버전이 지정된 설명서

MKDocs 쉬운 경량 문서 사이트와 관련하여 이전 제품일 수 있습니다. 그러나 강력하고 읽기 쉬운 문서를 작성하기에는 매우 간단합니다. ReadTheDocs 위에 구축

멋진 기능 중 일부:

버전 관리

단순 검색(하지만 강력함)

Markdown 구문을 사용하여 간단하면서도 강력한 페이지를 쉽게 작성합니다

.

정전기, 번개처럼 빠름

전문 사이트의 경우 사용자가 유용한 항목을 찾을 수 있는 간단한 문서 사이트가 필요했습니다.

현실 세계의 모든 것과 마찬가지로 문서화는 예정되거나 계획되지 않았지만 필요했습니다. PowerPoint를 문서나 사용자 가이드로 사용하는 대신에 비슷한 상황에 처한 적이 있었는데 결국 MKDocs

webapp을 사용하여 생성하려면 프로젝트 루트에 있는 yaml 파일만 있으면 됩니다azure-pipelines.yml.

여기에는 파이프라인 동작이 포함됩니다.

trigger:
- main

pool:
  vmImage: 'ubuntu-latest'

steps:
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.6'

- script: pip install mkdocs
  displayName: 'installing mkdocs'

- script: 'mkdocs build --clean'
  displayName: 'build mkdocs'

- task: AzureRmWebAppDeployment@4
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: 'Name of subscription with ID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)'
    appType: 'webAppLinux'
    WebAppName: '{appname}'
    packageForLinux: 'site/'
    RuntimeStack: 'STATICSITE|1.0'

첫 번째 부분

trigger:
- master

파이프라인에 대한 트리거를 설정하기만 하면 됩니다. -main는 우리가 들을 분기입니다. 따라서 main 분기에 변경 사항을 푸시할 때마다