GitHub

Manage your project documentation as Code

As an architect, the main product I deliver is a document named “Technical Architecture Document”. This document is basically a high level specification (not because it’s rocket science, it’s just a detailed global perspective) explaining how a software project will be implemented with the rest of the information system. And in most of the case, the template for this document is an Office suite-related document type such as a Microsoft Office document, or anything else.

July 8, 2023 - 15 minutes read time

Use a CI/CD workflow to maintain a book content

This may sound a little incongruous if for you the Continous Integration / Continuous Delivery patterns are for software development, but yes, you can maintain a book with the same principles. Recently, I’ve compiled the Linux Explained articles into an e-book. The idea was germinating in my head while writing the articles and I was wondering if I could maintaining the text using the CI/CD patterns. Actually : yes, it’s possible.

March 19, 2023 - 9 minutes read time

Terraform your CICD Toolchain : GitHub

When you’re running and managing the CICD Toolchain of a big organization, you may want to establish some conventions and usage rules to avoid having to manage a big inconsistent mess. One possibility to avoid this, after you had established your various naming conventions and usages, is to use Terraform to maintain all of the objects constitutes your application projects. For example, if your application’s sources are hosted on GitHub, using Actions for the build and SonarQube for the code quality analysis, you have to maintain both services : the repositories, the accesses, and the SonarQube project.

December 18, 2022 - 6 minutes read time

Yet Another Blogroll

During the previous week-end, I had a simple idea about if a blogroll directory could be made with a static-site generator like Hugo (the one I use here). After some tinkering, it appeared that it worked pretty nice, so I’ve launched it on the web and let see what will happen. So, I’m happy to introduce you Yet Another Blogroll, a humanly curated personal blog directory made with a static-site generator.

August 21, 2022 - 2 minutes read time

act for testing Github Action locally

Following my previous article about GitHub Actions, here is a new one that will explain how to locally test your Actions. Unlike the good old Jenkins on which you can copy/paste your pipeline code in a test job and run it (that’s dirty but it works), GitHub Actions requires to always commit and push your changes and wait for the runner to take it. When you’re like me and using a die and retry development process, it’s a waste of time.

April 16, 2022 - 7 minutes read time

Github Actions

GitHub Actions is a Continuous Integration, Delivery, and Deployment workflow manager made by the code repository hosting service GitHub. GitHub was a little late in the CI/CD pipeline management compared to its competitor GitLab and the good old Jenkins. After a beta testing period, the service opened in 2018. GitHub Actions is fully integrated with the service, accessible via the “Actions” tab on a repository (if the owner enabled it). The workflows are written in YAML with a declarative language describing the event triggering the pipeline, the runner kind, some environment-related informations, and the jobs definitions.

April 2, 2022 - 6 minutes read time

Misbrands : GitHub and GitLab

This third entry in our misbrands series will be about GitHub and GitLab, two famous code hosting (and other) services based on the Git SCM. This parodied version combine the GitHub name, written with the correct brand’s font, but associated with GitLab’s logo and with the same trademark layout. GitHub and GitLab are both competitors in the “DevOps platform” market by providing source code hosting services, Continuous Integration pipelines and runners, and Artifacts hosting.

March 25, 2022 - 6 minutes read time

I've shared my Hugo shortcodes on GitHub

A couple of weeks ago, I’ve made an article about how to use Hugo shortcodes and integrate them. I’ve decided to share them on GitHub, you can find them here : https://github.com/Wivik/hugo-shortcodes Until now, there are two of them : The exif metadata reader I’ve made previously. And another one I’ve never had the opportunity tu use : a Toot integration. Just copy a toot link to integrate it in your post.

January 23, 2022 - 1 minutes read time