GitLab r2401 scaffold

Securepub SPA on GitLab

• Create r2401 repository
• Add zola project scaffold and test files
• Verify GitLab Pages CI/CD build

Goals

• Setup r2401 repository for Securepub SPA.

Steps Taken

■ Create r2401 repo in GitLab ui
  - https://gitlab.com/projects/new#blank_project

  ■ New Project > Create Blank Project
    Project name
    r2401

    Project url
    https://securepub/r2401

    ✅  Private   ╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶ checked
    [ ] Initialize repository with a README ╶╶╶╶╶╶╶╶╶╶╶ unchecked

■ Adjust settings

  ■ Settings > Repository > Protected branches
    - ( x) Allow to force push ╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶ enabled

  ■ Settings > General > Visibility
    - uncheck lots of things:

    [ ] Require authentication to view media files ╶╶╶╶ unchecked

    Issues
    [ ] Flexible tool to collaboratively .... ╶╶╶╶╶╶╶╶╶ unchecked

    Container registry
    [ ] Every project can have its own space ... ╶╶╶╶╶╶ unchecked

    Analytics
    [ ] View project analytics. ╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶╶ unchecked

    Security and Compliance
    [ ] Security and compliance for this project. ╶╶╶╶╶ unchecked

    Wiki
    [ ] Pages for project documentation. ╶╶╶╶╶╶╶╶╶╶╶╶╶╶ unchecked

    Snippets
    [ ] Share code with others outside the project. ╶╶╶ unchecked

    Package registry
    [ ] Publish, store, and view packages ... ╶╶╶╶╶╶╶╶╶ unchecked
    [ ] Allow anyone to pull from Package Registry ╶╶╶╶ unchecked

    Model experiments
    [ ] Track machine learning model ... ╶╶╶╶╶╶╶╶╶╶╶╶╶╶ unchecked

    Model registry
    [ ] Manage machine learning models. ... ╶╶╶╶╶╶╶╶╶╶╶ unchecked

    Monitor
    [ ] Monitor the health of your project ... ╶╶╶╶╶╶╶╶ unchecked

    Environments
    [ ] Every project can make deployments ... ╶╶╶╶╶╶╶╶ unchecked

    Feature flags
    [ ] Roll out new features without ...  ╶╶╶╶╶╶╶╶╶╶╶╶ unchecked

    Infrastructure
    [ ] Configure your infrastructure..  ╶╶╶╶╶╶╶╶╶╶╶╶╶╶ unchecked

    Releases
    [ ] Combine git tags with release notes ... ╶╶╶╶╶╶╶ unchecked


■ Create securepub/r2401 workspace
  % cd ~/Securepub/
  % git clone git@gitlab.com:securepub/r2401.git
  % cd r2401
  % git config user.name securepub
  % git config user.email admin@securepub.org
  % git switch --create main
  - ... copy scaffold files
  % git add .
  % git commit -m "project scaffold and test files"
  % git push --set-upstream origin main


■ Test GitLab Pages
  ■ experiment with docker alpine
  ■ create .gitlab-ci.yml

    image: python:3-alpine
    variables:
      GIT_SUBMODULE_STRATEGY: recursive
    pages:
      script:
        - apk add --no-cache nodejs zola bash curl just
        - curl -L https://unpkg.com/@pnpm/self-installer | node
        - just gl2401
      artifacts:
        paths:
          - public
      only:
        - main

  ■ amend and push with Fork
  - GitLab job succeeded
  - Test url redirects to https://gl2401.securepub.org/_v1.2401_/test as expected

■ Examine job and artifacts
  - some paths missing
  - some .sync.py errors in build:
    00.test/_sync.conf: FAILURE
       s: zola/_index.md
       t: zola/content/_v1.2401_/test/
     [Errno 2] No such file or directory: '../work/zola/content/_v1.2401_/test'

  - probably need a .gitkeep 

■ add work/zola/content/_v1.2401_/test/.gitkeep

■ amend and push with Fork
  - GitLab job succeeded + no errors in build
  - previously missing paths now present