12 Commits

9 changed files with 80 additions and 17 deletions

View File

@ -0,0 +1,19 @@
name: Gitea Actions Demo
run-name: ${{ gitea.actor }} is testing out Gitea Actions 🚀
on: [push]
jobs:
Explore-Gitea-Actions:
runs-on: ubuntu-latest
steps:
- run: echo "🎉 The job was automatically triggered by a ${{ gitea.event_name }} event."
- run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by Gitea!"
- run: echo "🔎 The name of your branch is ${{ gitea.ref }} and your repository is ${{ gitea.repository }}."
- name: Check out repository code
uses: actions/checkout@v4
- run: echo "💡 The ${{ gitea.repository }} repository has been cloned to the runner."
- run: echo "🖥️ The workflow is now ready to test your code on the runner."
- name: List files in the repository
run: |
ls ${{ gitea.workspace }}
- run: echo "🍏 This job's status is ${{ job.status }}."

1
.sops.yaml Normal file
View File

@ -0,0 +1 @@
[]

View File

@ -1,4 +1,4 @@
FROM python:3.9-slim
FROM python:3.12-slim
WORKDIR /app

View File

@ -5,44 +5,72 @@
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
Cloudflare DDNS is a configurable Docker service updating your CloudFlare DNS records periodically
to match your local IP address.
Cloudflare DDNS is a configurable Docker service updating your CloudFlare DNS records periodically
to match your local IP address.
# Table of Content
- [Installation](#installation)
- [Cloudflare DDNS](#cloudflare-ddns)
- [Table of Content](#table-of-content)
- [Installation](#installation)
- [Using a Pre-built Container](#using-a-pre-built-container)
- [Building the Container Yourself](#building-the-container-yourself)
- [Hosting](#hosting)
- [Running on the Host](#running-on-the-host)
- [Configuration](#configuration)
- [Configuration](#configuration)
- [Getting a Cloudflare Token](#getting-a-cloudflare-token)
- [Supported Options](#supported-options)
- [Contributing](#contributing)
- [Contributing](#contributing)
## Installation
While this project is intended to be ran as a Docker container, it can also be ran on the host directly.
This container runs until terminated. It is not a cron job.
### Using a Pre-built Container
This project is available on the GitHub Container Registry.
```
docker pull ghcr.io/akarys42/cloudflare-ddns-docker
```shell
docker pull git.home.timatlee.com/timatlee/cloudflare-ddns:latest
```
### Building the Container Yourself
There are no special requirements when building this container! Simply use `docker build` in this folder.
There are no special requirements when building this container. Simply build with:
```shell
docker build -t git.home.timatlee.com/timatlee/cloudflare-ddns:latest .
docker push git.home.timatlee.com/timatlee/cloudflare-ddns:latest
```
#### Hosting
I am hosting this in my own Gitea repository. We can push this with:
```shell
docker login git.home.timatlee.com
username: timatlee
password: // Gitea PAT token
```
### Running on the Host
Python > 3.12 is required. This likely requires a virtualenv.
```shell
python -m venv .env
.env\scripts\activate.ps1
pip install -r requirements.txt
python -m cloudflare_ddns --token ... -d .. domain.example.com
```
In order to run this project on the host, you'll need Python > 3.8, and an environment containing
the dependencies listed in [`requirements.txt`](requirements.txt).
the dependencies listed in [`requirements.txt`](requirements.txt).
The project can then by launched by running the `cloudflare_ddns` module, usually using `python -m cloudflare_ddns`.
## Configuration
This project will accept parameters through environment variables or command line argument.
@ -71,5 +99,5 @@ Otherwise any found A or AAAA record pointing to this domain found will be used.
## Contributing
Any help would be greatly appreciated!
Any help would be greatly appreciated!
Feel free to check our [open issues](https://github.com/Akarys42/cloudflare-ddns-docker/issues) and send us a Pull Request!

View File

@ -1,13 +1,14 @@
import logging
from os import environ
from typing import Tuple
from dotenv import load_dotenv
import click
from cloudflare_ddns.app import ApplicationJob
from cloudflare_ddns.constants import BASE_ENV_VAR, DEFAULT_DELAY, DOMAINS_ENV_VAR
log = logging.getLogger("ddns")
load_dotenv()
@click.command()
@click.option(

View File

@ -1,5 +1,4 @@
## Development docker-compose
version: "3.7"
services:
cloudflare-ddns:
build:

9
renovate.json Normal file
View File

@ -0,0 +1,9 @@
{
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
"forkProcessing": "enabled",
"ignorePaths": [
".github"
]
}

View File

@ -1,6 +1,6 @@
flake8~=3.8.4
flake8-annotations~=2.4.1
flake8-bugbear~=20.1.4
flake8-bugbear~=24.4.26
flake8-docstrings~=1.5.0
flake8-import-order~=0.18.1
flake8-string-format~=0.3.0

View File

@ -1,2 +1,8 @@
requests~=2.25.1
click8~=8.0.1
certifi==2024.6.2
chardet==4.0.0
charset-normalizer==3.3.2
click==8.1.0
colorama==0.4.6
idna==2.10
requests==2.32.3
urllib3==2.2.1