Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/openshift-evangelists/kbe

Kubernetes By Example
https://github.com/openshift-evangelists/kbe

kubernetes

Last synced: 4 days ago
JSON representation

Kubernetes By Example

Awesome Lists containing this project

README

        

# Kubernetes By Example (KBE)

This repository contains the source code for website [`kubernetesbyexample.com`](http://kubernetesbyexample.com) using [Hugo](https://gohugo.io) as the website engine.

## Contribute

To contribute, please either raise an [issue](https://github.com/openshift-evangelists/kbe/issues)
describing what you want to see covered here or send in a PR to the `main` branch.
If you plan to contribute content, check out [content/page/](content/page/)
for the content in Markdown and [specs/](specs/) for respective YAML specifications.

## Build locally

1. Install `hugo` following the installation [guide](https://gohugo.io/overview/installing)
1. Get your local preview by running following command in the top-level dir:

```bash
hugo server --theme=beautifulhugo --buildDrafts
```

## Publish

For site admins only, requires push access to this repo.

### Setup

After cloning the repo, add the `gh-pages` branch as a submodule under the `public` folder:

```bash
git submodule add -f -b gh-pages [email protected]:openshift-evangelists/kbe.git public
```

### Updates

To update the live site with new content:

```bash
# still in top-level dir build the content in public/ dir:
hugo --theme=beautifulhugo
# add generated content (which lives in the gh-pages branch):
cd public/
git add --all
git commit -m "release notes go here..."
git push -f origin gh-pages
```

## References

- https://themes.gohugo.io/beautifulhugo/
- https://gohugo.io/overview/configuration/
- https://gohugo.io/overview/quickstart/
- https://gohugo.io/tutorials/github-pages-blog/