GitLab Pages、sphinxで生成されたドキュメント

Question

GitLab PagesにSphinxで生成された静的ページをホストしたい。ビルド済みindex.htmlファイルは次の場所にあります：

project/docs/build/html

どうやって .gitlab-ci.ymlページをデプロイするように見えますか？私はそのようなものを持っていますが、うまくいきません：

pages:
  stage: deploy
  script:
  - echo 'Nothing to do...'
 artifacts:
 paths:
 - docs/build/html
 only:
 - master

Answer 1

。gitlab-ci.ymlのドキュメント によると、pagesジョブには特別なルールがありますmust従う：

1. 静的コンテンツはpublic/ディレクトリの下に配置する必要があります
2. artifactsとpublic/ディレクトリへのパスを定義する必要があります

したがって、あなたが与えた例.gitlab-ci.ymlは次のようになります：

pages:
  stage: deploy
  script:
    - mv docs/build/html/ public/
  artifacts:
    paths:
    - public
  only:
  - master

もちろん、何らかの理由でhtmlフォルダを移動したくない場合は、代わりにコピーできます。

参考までに、この質問を最初に投稿した頃に GitLab Pagesの例sphinxプロジェクト がプッシュされました。