https://github.com/ironpeakservices/iron-chart-hugo

Develop a Hugo website and automatically publish a Helm Chart using just GitHub.
https://github.com/ironpeakservices/iron-chart-hugo

helm hugo iron kubernetes

Last synced: 3 months ago
JSON representation

Develop a Hugo website and automatically publish a Helm Chart using just GitHub.

• Host: GitHub
• URL: https://github.com/ironpeakservices/iron-chart-hugo
• Owner: ironpeakservices
• License: apache-2.0
• Created: 2021-01-13T09:34:44.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2021-02-16T08:08:16.000Z (almost 4 years ago)
• Last Synced: 2023-03-03T03:40:47.822Z (almost 2 years ago)
• Topics: helm, hugo, iron, kubernetes
• Language: HTML
• Homepage:
• Size: 10.8 MB
• Stars: 9
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# iron-chart-hugo

Example repository to develop a Hugo website and automatically publish to a Helm chart using security best practices on GitHub.

Let's develop in Kubernetes too. Fork me!

When developping locally your website any changes will be automagically trigger Hugo to rebuild.

Production container images pushed to GitHub will use your build code served by a hardened instance of nginx.

## Development

```shell

# this deploys as a helm chart to your default kubernetes context

% make

# see the pods being created

% kubectl get pods

# now edit the website source code to see it reload live!

```

## Debugging

```shell

# see what's holding up the Pod

% kubectl logs 

# try to remove and redeploy the Chart

% make clean build up logs

```

## Releasing

1. Push your changes to `dev` or a feature branch.

2. Open a Pull Request and see your changes get linted, built and tested!

3. Merge to publish a new Helm Chart release.

## Usage

```shell

# first add our helm repository

# provide a GitHub token if it's private

% helm repo add ironcharthugo https://${GITHUB_TOKEN}@raw.githubusercontent.com/ironpeakservices/iron-chart-hugo/helmrepo/

"ironcharthugo" has been added to your repositories

# now let's install our Chart from our repository

% helm install mychart ironcharthugo/iron-chart-hugo

```

## Forking

1. Fork the repository

2. Change all references to ironpeakservices, hazcod or this repository.

3. Provide your GitHub secret names in `.github/workflows/`.

4. Create a `helmrepo` branch which will host your Chart tarballs.