eggs/CONTRIBUTING.md

53 lines
1.8 KiB
Markdown
Raw Normal View History

2018-02-17 11:05:28 +08:00
# So you want to make an Egg
## General rules
2018-07-21 08:40:07 +08:00
1. Keep it simple.
We don't need 8 miles of install script.
2018-07-21 08:40:07 +08:00
2. Keep it Small.
Only use what is absolutely needed.
2018-07-21 08:40:07 +08:00
3. Try to stay in the stock containers.
If you need something in a container, open a PR in [my yolks repo](https://github.com/parkervcp/yolks) where I can review and pull it up to the main repo. In addition, there is a larger quantity of [images here](https://github.com/parkervcp/images) for you to use that have not been migrated to Yolks yet.
2018-02-17 11:05:28 +08:00
4. Don't be afraid to submit PR's to the egg repo.
2020-03-03 22:43:34 +08:00
I don't bite. I will work with you on the egg and the required things to run it.
## Step 1
### Be aware of the pterodactyl install process
2018-02-17 11:05:28 +08:00
The Pterodactyl install process is fairly simple once you know.
```md
2018-02-17 11:05:28 +08:00
1. Spin up install container
This uses a volume mount on /mnt/server for the server files.
This can pull or set up all that is needed to run the server.
It is regularly used to just download the files required. Such as server files and configs.
2021-12-13 08:55:36 +08:00
2018-02-17 11:05:28 +08:00
2. Stop install container
2021-12-13 08:55:36 +08:00
2018-02-17 11:05:28 +08:00
3. Start a new container with the server files in /home/container
This is where the server is actually run.
Any dependencies installed during the install process are gone.
The container that is started should have everything you need.
```
## Step 2
2018-02-17 11:05:28 +08:00
### Testing
2018-02-17 11:05:28 +08:00
Make sure your install process is rock solid as I will be testing eggs before they ever hit my repo.
I will make suggestions and changes at will.
2018-02-17 11:05:28 +08:00
This is to maintain a clean repo that others can pull and be fully aware of what is being done.
## Step 3
2018-02-17 11:05:28 +08:00
### Make a branch and do your work in there
2018-02-17 11:05:28 +08:00
2020-03-03 22:43:34 +08:00
I have been getting messy PR's due to people always PRing from their master branch. Please make a seperate branch and PR from there.