Welcome to the GIIS Tech Club DNS Hub! 🚀

Ready to dive into the world of DNS and help shape the infrastructure of giistech.club? Whether you're a tech enthusiast or a curious explorer, this is your chance to make a tangible impact with just a few clicks. By tweaking a YAML file and opening a pull request, you'll set the wheels in motion, automatically updating our DNS records with Cloudflare. Let's get started!

Why DNS?

DNS (Domain Name System) is like the internet's phonebook, translating human-readable domain names into IP addresses. It's crucial for:

• Website Hosting: Directing domain names to server IPs so visitors can reach your website.
• Email Routing: Ensuring emails reach the right destination through MX records.
• Service Discovery: Helping applications locate services through SRV records.
• Security: Using TXT records for configurations like SPF to protect email authenticity.

How to Contribute DNS Records

Step 1: Fork the Repository

• Click the "Fork" button at the top right of this repository page.

Step 2: Edit Files via GitHub

1. Go to Your Fork: Navigate to your forked repository.

2. Open the File: Find and open giistech.club.yaml.

3. Edit the YAML File: Click the pencil icon to edit.

• Add or modify records using this structure:

  subdomain:
    ttl: <TTL value in seconds>
    type: <Record type (A, CNAME, MX, etc.)>
    value: <Record value>
    octodns:
      cloudflare:
        proxied: <true/false>
        auto_ttl: <true/false>

  Example - A Record:

  example:
    ttl: 60
    type: A
    value: 203.0.113.0
    octodns:
      cloudflare:
        proxied: true
        auto_ttl: true

Step 3: Commit Changes

• After editing, provide a commit message, select "Create a new branch", and propose the changes.

Step 4: Create a Pull Request

• Click on "Pull requests" in your forked repository.
• Click "New pull request".

• Write a description of your changes and submit the PR.

Automatic Synchronization

• Once the PR is reviewed and merged, a GitHub Action will automatically sync changes with Cloudflare.

Advanced Record Types

A Record

example:
  ttl: 300
  type: A
  value: 203.0.113.0
  octodns:
    cloudflare:
      proxied: true
      auto_ttl: true

CNAME Record

alias:
  ttl: 300
  type: CNAME
  value: target.domain.com.
  octodns:
    cloudflare:
      proxied: false
      auto_ttl: true

Troubleshooting

• Ensure YAML syntax is correct.
• Check PR comments for any feedback or requested changes.

For further details, refer to the OctoDNS documentation.