This website chooses a "true" random winner for CS:GO case openings.
Table of contents
What is this website for?
This website chooses a "true" random winner for any type of raffle. It's made especially for CS:GO Case openings.
A "true" random winner?
How do I start?
All the information RandomWinPicker needs is given in 2 simple steps:
- Tell RandomWinPicker who participates in your raffle and how great the chance of winning for each user is. For example, the chances of winning may depend on the amount of CS:GO keys a user has donated.
- Choose all items that can be won by any user in a certain winning category. Maybe a knife skin can be won on the first place.
One day a YouTuber, Megaquest, who I was subscribed to, asked in one of his CS:GO case opening videos if a subscriber of his channel could create a way for him to improve the way he draws the case opening's winner. Until then he made lists and used random.org to pick a winner manually from the list. This method was relatively unoptimized visually as well as methodically. I decided to jump in, contact him and create a website for that purpose.
This website was not my absolutely first one to create, but the first one to finish. I stopped working on other projects and focused on finishing this one. I was by no way a professional in creating websites and thus the original code contains many flaws. Another step I skipped was building and deploying. I had no idea that tools like Gulp or Travis existed. Therefore there was only production mode: I developed the live site. On one hand the site was up as fast as possible, on the other hand it contained many bugs. Those can be seen in Megaquest's first videos, in which he used my website for his case openings.
Regarding hosting and availability I completely relied on my Raspberry Pi at home. It served the site via Apache and went down a few times rendering the site unusable. This was especially critical when I was not at home and not able to restart the Pi right away. I had a website downtime alert service in place though.
Well, one way or another, the website found its use in some of Megaquests videos. Unfortunately not for a long time. Pretty soon new case opening videos became less and less until he created no new ones any more. I can't tell whether he was completely satisfied with my website. He made the impression that he liked this new and comfortable way to arrange his case opening videos, but did not like it when he found bugs ... of course. Sadly he stopped making those videos and, as far as I can tell, noone else used my site as extensively as he did. I decided to stop paying for the domain randomwinpicker.de in mid-2017. Megaquest stopped uploading videos in January 2018.
HTTPs/SSL encryption requires certificates. Those can easily be generated using the new-certificates.sh script. The root certificate needs to be imported in your browser.
To keep confidential data, like usernames and passwords, out of the source code they need to be accessible as Docker secrets. Under
docker/secrets/ these files, which contain the passwords' values, need to exist:
Don't use password files for production though. Use the
docker secret create command instead. PowerShell on Windows may add a carriage return at the end of strings piped to the command. A workaround can be that you create secrets from temporary files that do not contain a trailing newline. They can be written using:
"secret data" | Out-File secret_name -NoNewline
When done, shred those files!
The default configuration assumes that the local development is done on
randomwinpicker.test. Therefore one needs to configure the local DNS resolution to make this address resolvable. This can either be done by simply adding this domain and all subdomains to the operation system's hosts file or by settings up a local DNS server. An advantage of the latter method is that subdomain wildcards can be used and thus not every subdomain needs to be defined separately.
# Use NetworkManager's resolv.conf resolv-file=/run/NetworkManager/resolv.conf # Limit to machine-wide requests listen-address=127.0.0.1 # Wildcard DNS address=/randomwinpicker.test/127.0.0.1 # Enable logging (systemctl status dnsmasq) #log-queries
[main] # Don't touch /etc/resolv.conf rc-manager=unmanaged
Remember to create the
credentials/.env file using the provided template to enable complete functionality.
Composer task to be executed you need to have PHP installed. Make sure that the following settings are made in your
date.timezone = UTC extension=gd
date.timezone = UTC extension=gd2 extension_dir = "ext"
Build & Deploy
All required Node.js dependencies can be installed using Yarn. By default the
yarn command utilizes the
package.json file to automatically install the dependencies to a local
node_modules folder. Instructions on how to install Yarn can be found here.
This repository contains all scripts needed to build this project. The
gulpfile.js automatically manages tasks like cleaning the build (
dist) folder, copying files to it, managing dependencies with composer and yarn, creating symlinks and a zip file and finally watching for any changes.
By default the
gulp command executes all necessary functions to build the website. If the gulp-cli is not installed globally, you need to run
yarn global add gulp-cli first.
How you choose to integrate the built project is up to you. A
dockerfile and a
stack.yml template are provided to make deployment a breeze.
dockerfile enables you to build a PHP/Apache-Server with the configuration files in the
docker folder. It can be run as a Docker container just as you wish, but this alone makes the site not fully functional. Additional services like a reverse proxy are needed. Those can be defined in the
stack.yml file, which describes a stack that can be deployed on a swarm. With this file the deployment is complete.
To generate a development version of this file you can use PS-Docker-Management. It simplifies development of Docker projects like this one. To setup this project's full Docker stack locally just run this command:
./Invoke-PSDockerManagement.ps1 -ProjectPath ../randomwinpicker.de/
Utilize deploy.sh for automatic deployment.
production/stack.yml file to deploy the predefined stack on a server. You need to specify environment variables as outlined in the
.env contains environment variables for the stack file itself. Use a command similar to this for deployment where
-E indicates preserved environment variables for
sudo -E docker stack deploy -c stack.yml randomwinpicker-de
traefik.env sets provider credentials for DNS authentication as environment variables for the traefik service.
Adminer / PostgreSQL
Values in square brackets are Docker secrets.
You can access the main website locally at randomwinpicker.test.
You can access the reverse proxy's dashboard locally at traefik.randomwinpicker.test.
This website is currently not reachable through an own domain. My plan is to migrate the website to a subsite of my website jonas-thelemann.de to keep it available. The original creation of this website consumed way too many hours of my free time to let it vanish somewhere on my harddrive. Thus, I decided to publish the source code to GitHub.
Creating this repository from the legacy code I initially wrote was time consuming too, but I learned to use tools like Gulp, Yarn, Docker, Composer, environment variables and a reverse proxy, which moves me one step closer to publishing the source code of my main website. I learned many best practises on how to create a website repository and about state of the art web technologies (which this website does not but could include). Over the next months I hope that I'll find time to improve the source code to meet my own quality requirements. But until then I hope someone else finds this repository useful. Be it that you want to create your own website or try to hack mine ;)