Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://github.com/statnmap/GitLab-Pages-Deploy below:

statnmap/GitLab-Pages-Deploy: Bash to deploy GitLab Pages in a branch like gh-pages

Bash to deploy GitLab Pages in a branch like gh-pages
(Highly inspired from https://github.com/marketplace/actions/gh-pages-deploy)

It allows to keep track of modifications between to publications

• This creates a branch named "gh-pages"
• This stores the content of your branch "public/" directory inside

Also, if you want to be able to render the website for some specific branches, without deleting the 'main' one, you can use sub-website build. See Publish one sub-website for each branch

You can find repository with a demo for this script: https://gitlab.com/statnmap/gitlab-pages-demo/-/blob/main/README.md
You'll see Pages with sub-folders of the HTML output for each branch that is worth it.

On GitLab, you can choose to publish the "gh-pages" branch instead of the public artifacts using this in the ".gitlab-ci.yml":

gh-pages-prep:
    stage: prepare-deploy
    only:
      - main
    script:
      # Deploy a unique site in gh-pages branch,
      # or a sub-website for each branch if SITE_BY_BRANCH: "TRUE"
      - wget https://raw.githubusercontent.com/statnmap/GitLab-Pages-Deploy/main/deploy_pages_branch.sh
      - /bin/bash deploy_pages_branch.sh
      
pages:
    stage: deploy
    script:
        - echo "deploy"
    artifacts:
        paths:
            - public
    only:
        # Because we use "deploy_pages_branch", only gh-pages branch needs to be deployed
        # All outputs from other branches in "prepare-deploy" step will push in "gh-pages"
        - gh-pages

Also think about using except: gh-pages in your other stages because no file is available for this branch.

• Go to: Settings > Access Token
  • If it is not activated, use a personal access token: https://gitlab.com/-/profile/personal_access_tokens
• Choose a proper name to recognize it when you'll want to revoke it
• Choose role as "Developer"
• Check access: read_repository and write_repository
• Save your token, you will only see it once

• Go to: Settings > CI/CD > Variables
• Expand the section
• Add variable
• Fill key with PROJECT_ACCESS_TOKEN
• Fill the token with the one you saved above
• Mask variable but you can uncheck Protect variable
• Add variable

If you use the environment variable :

variables:
  SITE_BY_BRANCH: "TRUE"
  
 gh-pages-prep:
    stage: prepare-deploy
    only:
      - master
      - main
      - production
      - validation
    script:
      # Deploy a unique site in gh-pages branch,
      # or a sub-website for each branch if SITE_BY_BRANCH: "TRUE"
      - wget https://raw.githubusercontent.com/statnmap/GitLab-Pages-Deploy/main/deploy_pages_branch.sh
      - /bin/bash deploy_pages_branch.sh
      
pages:
    stage: deploy
    script:
        - echo "deploy"
    artifacts:
        paths:
            - public
    only:
        # Because we use "deploy_pages_branch", only gh-pages branch needs to be deployed
        # All outputs from other branches in "prepare-deploy" step will push in "gh-pages"
        - gh-pages

The 'gh-pages' branch will keep site content of other published branches in a dedicated subdirectory.
This will then create an index file at the root of your website to let you choose which version you want to see.

<h2>Index of branch directories</h2>

- index.html
- master
- production
- validation
- other-branch

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4