docs: add docs
This commit is contained in:
parent
c786404692
commit
7d8ff5fd1e
11 changed files with 159 additions and 0 deletions
35
.github/workflows/docs.yml
vendored
Normal file
35
.github/workflows/docs.yml
vendored
Normal file
|
|
@ -0,0 +1,35 @@
|
||||||
|
name: Release Docs
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
tags:
|
||||||
|
- "v*"
|
||||||
|
branches:
|
||||||
|
- main
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
release_docs:
|
||||||
|
name: Release Docs
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v3
|
||||||
|
with:
|
||||||
|
fetch-depth: 0
|
||||||
|
- uses: actions/setup-python@v2
|
||||||
|
with:
|
||||||
|
python-version: "3.10"
|
||||||
|
cache: "pip"
|
||||||
|
cache-dependency-path: "./docs/scripts/requirements.txt"
|
||||||
|
- run: |
|
||||||
|
pip install -r docs/scripts/requirements.txt
|
||||||
|
- name: setup
|
||||||
|
run: |
|
||||||
|
./docs/scripts/copy-docs.sh
|
||||||
|
- name: Configure Git user
|
||||||
|
run: |
|
||||||
|
git config --local user.email "github-actions[bot]@users.noreply.github.com"
|
||||||
|
git config --local user.name "github-actions[bot]"
|
||||||
|
- name: build and push
|
||||||
|
run: |
|
||||||
|
mike deploy ${{ github.ref_name }} latest --push --update-aliases
|
||||||
|
mike set-default --push latest
|
||||||
3
docs/getting-started/install.md
Normal file
3
docs/getting-started/install.md
Normal file
|
|
@ -0,0 +1,3 @@
|
||||||
|
# Install
|
||||||
|
|
||||||
|
TODO
|
||||||
3
docs/getting-started/uninstall.md
Normal file
3
docs/getting-started/uninstall.md
Normal file
|
|
@ -0,0 +1,3 @@
|
||||||
|
# Uninstall
|
||||||
|
|
||||||
|
TODO
|
||||||
3
docs/getting-started/upgrade.md
Normal file
3
docs/getting-started/upgrade.md
Normal file
|
|
@ -0,0 +1,3 @@
|
||||||
|
# Upgrade
|
||||||
|
|
||||||
|
TODO
|
||||||
22
docs/index.md
Normal file
22
docs/index.md
Normal file
|
|
@ -0,0 +1,22 @@
|
||||||
|
---
|
||||||
|
title: Home
|
||||||
|
hide:
|
||||||
|
- navigation
|
||||||
|
- toc
|
||||||
|
---
|
||||||
|
|
||||||
|
# Pterodactyl on Kubernetes
|
||||||
|
|
||||||
|
This project brings the awesome Pterodactyl Panel to Kubernetes.
|
||||||
|
|
||||||
|
## Helm chart
|
||||||
|
|
||||||
|
Helm chart is currently not available in the GitHub repository, it is in really early stage. For more, see [Roadmap](roadmap.md).
|
||||||
|
|
||||||
|
## Docker image
|
||||||
|
|
||||||
|
Docker images are currently built nightly and on push, the CI will be tweaked later, see [Roadmap](roadmap.md)
|
||||||
|
|
||||||
|
## LICENSE
|
||||||
|
|
||||||
|
This project is licensed with MIT License, see [LICENSE](https://github.com/acaslab/pterodactyl-on-k8s/blob/main/LICENSE) in the repository.
|
||||||
13
docs/internals/docker-build.md
Normal file
13
docs/internals/docker-build.md
Normal file
|
|
@ -0,0 +1,13 @@
|
||||||
|
# Docker build
|
||||||
|
|
||||||
|
There are currently two channels setup.
|
||||||
|
|
||||||
|
Nightly and release.
|
||||||
|
|
||||||
|
## Nightly
|
||||||
|
|
||||||
|
Nightly as the name suggest is build every night on schedule with latest version of Pterodactyl Panel.
|
||||||
|
|
||||||
|
## Release
|
||||||
|
|
||||||
|
Release on the other hand is build with tagged versions of Pterodactyl Panel and is considered to be used in production.
|
||||||
15
docs/internals/releases.md
Normal file
15
docs/internals/releases.md
Normal file
|
|
@ -0,0 +1,15 @@
|
||||||
|
# Releases
|
||||||
|
|
||||||
|
Currently releases are hand made, but it is planned to automate the release process via GitHub Actions.
|
||||||
|
|
||||||
|
For more information, see [Roadmap](../roadmap.md)
|
||||||
|
|
||||||
|
## Versioning
|
||||||
|
|
||||||
|
As said in the [Changelog](../changelog.md), this project is currently under active development and releases are following [zer0ver](https://0ver.org/) until a stable release.
|
||||||
|
|
||||||
|
When times come for a stable release, [Semantic Versioning](https://semver.org/spec/v2.0.0.html) will be strictly followed.
|
||||||
|
|
||||||
|
## Stable release
|
||||||
|
|
||||||
|
There is currently no ETA.
|
||||||
21
docs/roadmap.md
Normal file
21
docs/roadmap.md
Normal file
|
|
@ -0,0 +1,21 @@
|
||||||
|
---
|
||||||
|
hide:
|
||||||
|
- navigation
|
||||||
|
---
|
||||||
|
|
||||||
|
# Roadmap
|
||||||
|
|
||||||
|
|
||||||
|
## Phase one: Proof of Concept
|
||||||
|
|
||||||
|
- [X] Docker image build
|
||||||
|
- [ ] Basic Helm chart
|
||||||
|
|
||||||
|
## Phase two: Automation
|
||||||
|
|
||||||
|
- [ ] Automate releases with GitHub Actions
|
||||||
|
- [ ] Kubernetes autoscaling via [HPA](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/)
|
||||||
|
|
||||||
|
## Phase three: Stable release
|
||||||
|
|
||||||
|
- [ ] Create first stable release (e.g. `1.0.0`)
|
||||||
3
docs/scripts/copy-docs.sh
Normal file
3
docs/scripts/copy-docs.sh
Normal file
|
|
@ -0,0 +1,3 @@
|
||||||
|
set -eo pipefail
|
||||||
|
|
||||||
|
cp CHANGELOG.md changelog.md ./docs/
|
||||||
3
docs/scripts/requirements.txt
Normal file
3
docs/scripts/requirements.txt
Normal file
|
|
@ -0,0 +1,3 @@
|
||||||
|
mkdocs == 1.3.1
|
||||||
|
mkdocs-material == 8.4.3
|
||||||
|
mike == 1.1.2
|
||||||
38
mkdocs.yml
Normal file
38
mkdocs.yml
Normal file
|
|
@ -0,0 +1,38 @@
|
||||||
|
site_name: Pterodactyl on Kubernetes Docs
|
||||||
|
site_url: https://docs.acaslab.com/pterodactyl-on-k8s
|
||||||
|
|
||||||
|
repo_url: https://github.com/acaslab/pterodactyl-on-k8s/
|
||||||
|
repo_name: acaslab/pterodactyl-on-k8s
|
||||||
|
|
||||||
|
edit_uri: edit/main/docs/
|
||||||
|
|
||||||
|
nav:
|
||||||
|
- Home: index.md
|
||||||
|
- Getting Started:
|
||||||
|
- Install: getting-started/install.md
|
||||||
|
- Upgrade: getting-started/upgrade.md
|
||||||
|
- Uninstall: getting-started/uninstall.md
|
||||||
|
- Roadmap: roadmap.md
|
||||||
|
- Internals:
|
||||||
|
- Releases: internals/releases.md
|
||||||
|
- Docker build: internals/docker-build.md
|
||||||
|
- Changelog: changelog.md
|
||||||
|
|
||||||
|
theme:
|
||||||
|
name: material
|
||||||
|
locale: en
|
||||||
|
highlightjs: true
|
||||||
|
features:
|
||||||
|
- navigation.tabs
|
||||||
|
- navigation.tracking
|
||||||
|
- navigation.sections
|
||||||
|
- toc.follow
|
||||||
|
|
||||||
|
extra:
|
||||||
|
version:
|
||||||
|
provider: mike
|
||||||
|
default: latest
|
||||||
|
|
||||||
|
markdown_extensions:
|
||||||
|
- pymdownx.tasklist:
|
||||||
|
custom_checkbox: true
|
||||||
Reference in a new issue