Beginner's Guide: Hugo + Gitlab CI + Surfer

[vjvanjungg]

@girish thanks, we’re just letting the gitlab ci do the work, that’s how i understand it now. if that what u mean be build server, enlighten me otherwise

[adrw]

@vjvanjungg Great tutorial! I wouldn't have guessed it'd be so easy to have a full CI + deploy for a static site all within Cloudron.

[atrilahiji]

@girish This appears to be on gitlab.com so it uses their shared CI runners.

@vjvanjungg I would suggest adding a note about using a Cloudron or other self hosted gitlab instance. You would need to host your own gitlab-runner for this to work.

I am now realizing that I didn't include this in my guide...

[girish]

@atrilahiji said in Beginner's Guide: Hugo + Gitlab CI + Surfer:

@girish This appears to be on gitlab.com so it uses their shared CI runners.

Yes, my bad, I missed the gitlab.com URL !

[atrilahiji]

Either way guides like this are perfect. IMO git driven static sites via static site generators are the best way to do static sites. No sense having a server or DB behind a site to serve articles or add new pages.

Best part is, if you want to roll back a change you have the entire history of your site available as "backups" on git. Just revert a commit.

[vjvanjungg]

@adrw yesh, me too when i saw it live! shout out to @atrilahiji too, if you haven’t watched his video come and watch it , it’s what inspired this one with great info:

https://video.lahijiapps.dev/videos/watch/3540b0bb-553f-43bb-8087-fa8e26fd0d46

[atrilahiji]

@vjvanjungg glad it could help! I’m hoping to get around to making more guides for things but I do this reactively mostly. Perhaps a guide for building basic Vue frontend apps or personal sites?

[robi]

does gitea or gogs not have any CI?

[girish]

@robi I think they only integrate with existing CI systems like drone.

[atrilahiji]

@robi Drone is the best one right now. @fbartels did offer to package it if there was interest and I believe he wanted it to be sponsored. I would check that out.

[fbartels]

Drone indeed integrates quite easily with Gitea. More information on my app offering can be found at https://forum.cloudron.io/topic/3350/offered-drone-ci-on-cloudron

The one thing I particularly like is that I only need the "Dashboard" to be centrally hosted, all the job runners can run inside private networks. The runner is a small golang binary that can easily be launched with docker-compose. This allows me to simply start the runner on whatever device I am currently working (desktop, laptop, chromebook, mini homeserver).

This is my drone configuration to build my hugo site and deploy it to my surfer instance:

---
kind: pipeline
name: blog
concurrency:
  limit: 1
steps:
  - name: submodules
    image: alpine/git
    commands:
      - git submodule update --init --recursive --remote
  - name: build
    image: plugins/hugo
    settings:
      hugo_version: 0.79.0
      extended: true
      validate: true
  - name: deploy
    image: 'fbartels/cloudron-surfer:5.12.2'
    environment:
      SURFTOKEN:
        from_secret: surftoken
    commands:
      - surfer --version
      - touch public/ # touch folder to avoid problems with timestamps
      - surfer put --token $SURFTOKEN --server blog.9wd.eu ./public/* /
    when:
      branch:
        - master
      event:
        exclude:
          - pull_request
  - name: Notification Rocket.Chat
    image: rmilewski/drone-rocket:latest
    when:
      status:
        - success
        - failure
    settings:
      webhook: https://chat.9wd.eu/hooks/$(ROCKETSECRET)
      username: rocket.cat
      channel: drone
      color:
        - value: green
          when:
            DRONE_BUILD_STATUS: success
        - value: red
          when:
            DRONE_BUILD_STATUS: failure
      message:
        - value: "Build: ${DRONE_BUILD_NUMBER} succeeded. Good job."
          when:
            DRONE_BUILD_STATUS: success
        - value: "Build: ${DRONE_BUILD_NUMBER} failed. Fix me please."
      text: ${DRONE_COMMIT_MESSAGE}
      fields:
        - title: Author
          value: ${DRONE_COMMIT_AUTHOR}
        - title: Demo
          value: "This field will only be visible if the current branch: ${DRONE_COMMIT_BRANCH} is master or production"
          when:
            DRONE_COMMIT_BRANCH:
              - master
              - production

[girish]

@fbartels IIRC, a complication with packaging drone was that it required ENV vars to be set before the app is even started. Like you have to select the integration type etc. Is that still the case? If so, how would a Cloudron installation UX for this look like? Just choose some default and let the user edit the config file?

[robi]

@girish bring up the app with first run instructions then on restart it reconfigures to prod.

[fbartels]

@girish kind of what @robi said. At first startup it creates a config file in the app that still needs to be manually edited in regards to where Gitea can be reached as well as its configured client id and secret.

I did add you to the repo a while ago, so you can also have a direct look at https://github.com/fbartels/cloudron-drone-app/

[jdaviescoates]

@fbartels said in Beginner's Guide: Hugo + Gitlab CI + Surfer:

I did add you to the repo a while ago, so you can also have a direct look at https://github.com/fbartels/cloudron-drone-app/

I'm getting a 404 there.

[atrilahiji]

@jdaviescoates Its a private repo. He'd have to invite you to it via your Github account.

[fbartels]

@jdaviescoates it's a private repo. You can get access by sponsoring me on GitHub. More details at https://forum.cloudron.io/topic/3350/offered-drone-ci-on-cloudron

[atrilahiji]

@fbartels Beat me to it :^)

[fbartels]

@atrilahiji i would have said it's the other way around

[jdaviescoates]

@atrilahiji @fbartels ah, I see, thanks