Get free subdomains for your OSS projects.

For a project name foo, you can have your own subdomain foo.oss.wtf. Just add a simple configuration.

In [oss.wtf](https://github.com/karan/oss.wtf/tree/master/oss.wtf) directory, add a file called foo.tf with contents:

resource "google_dns_record_set" "foo-oss-wtf" {
  name         = "foo.oss.wtf."
  managed_zone = "oss-wtf"
  type         = "A"
  ttl          = 300

  rrdatas = ["1.3.3.7"]
}

1. Change foo in foo.oss.wtf. and foo-oss-wtf to your subdomain. Change the rrdatas IP to your service's IP.

2. You can set pretty much any DNS record. Follow the guide here.

3. Send a PR and as soon as it's checked in, the DNS record should be set soon after.

To check if the DNS policy is set, try dig:

$ dig @1.1.1.1 foo.oss.wtf | grep -A 1 "ANSWER SECTION"
;; ANSWER SECTION:
foo.oss.wtf.        281 IN  A   1.3.3.7

This is a side project for me, and I really want to optimize for least amount of effort and stress for the both of us.

You should know the following rules:

1. This is a side project for me, and not a job.

2. I do not provide any SLOs or guarantees on either PR reviews, or support.

3. The DNS is Google so it's pretty stable, but sometimes software breaks. Do not yell at me if that happens.

4. I will only approve subdomains for webpages related to OSS projects. As such, your PR must include a link to a public repo for your project.

5. I will allow most content. I will not allow anything illegal, hateful, hurtful, shady, spammy etc. I have final say over what goes in.

6. I can remove your subdomain if you are being a jerk (to me, or to others). I do not owe you an explanation in that case.

7. If I decide to end this project, I will try my best to let you know (with a ~30 day notice).

8. This is a side project for me, and not a job.

On Github, set the following secrets:

1. GCPPROJECT - string name of the GCP project

2. ACCOUNTJSON - The string content of a GCP service account

To test locally,

$ ./oss.wtf/run.sh $GCP_PROJECT_NAME

Inspired by yarmo