Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/schema/ip-ranges.schema.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/truefoundry/nat-ips/main/.github/schema/ip-ranges.schema.json",
"$id": "https://raw.githubusercontent.com/truefoundry/ip-ranges/main/.github/schema/ip-ranges.schema.json",
"title": "TrueFoundry IP ranges",
"description": "Outbound NAT addresses for one control plane. The directory (eu or us) is the control plane.",
"type": "object",
Expand Down
2 changes: 1 addition & 1 deletion .github/scripts/build.py
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@
ROOT = Path(__file__).resolve().parents[2] # .github/scripts/build.py -> repo root
DIST_DIR = ROOT / "dist"
PLANES = ("eu", "us")
REPO = "https://github.com/truefoundry/nat-ips"
REPO = "https://github.com/truefoundry/ip-ranges"


def flat_ips(endpoints: list[dict]) -> list[str]:
Expand Down
5 changes: 3 additions & 2 deletions .github/scripts/release_notes.py
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,8 @@
from datetime import datetime, timedelta, timezone
from pathlib import Path

REPO = "https://github.com/truefoundry/nat-ips"
REPO = "https://github.com/truefoundry/ip-ranges"
PAGES = "https://truefoundry.github.io/ip-ranges"
PLANES = ("eu", "us")
ACTIVATION_DAYS = 15

Expand Down Expand Up @@ -164,7 +165,7 @@ def main() -> int:
)
lines += [
"- Plain text, one CIDR per line: swap `.json` for `.txt`.",
f"- Always-latest: {REPO}/releases/latest/download/eu.json",
f"- Always-latest: {PAGES}/eu.json",
"",
]

Expand Down
43 changes: 43 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,9 @@ on:

permissions:
contents: write
actions: write
pages: write
id-token: write

concurrency:
group: release
Expand Down Expand Up @@ -118,3 +121,43 @@ jobs:
--notes-file "${RUNNER_TEMP}/notes.md" \
--latest \
dist/*

- name: Prepare the GitHub Pages site
if: ${{ !inputs.dry_run }}
run: |
mkdir -p site
cp dist/eu.json dist/us.json dist/eu.txt dist/us.txt site/
cat > site/index.html << 'EOF'
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>TrueFoundry IP ranges</title>
</head>
<body>
<h1>TrueFoundry IP ranges</h1>
<ul>
<li><a href="eu.json">EU JSON</a> · <a href="eu.txt">EU text</a></li>
<li><a href="us.json">US JSON</a> · <a href="us.txt">US text</a></li>
</ul>
</body>
</html>
EOF

- name: Upload the GitHub Pages artifact
if: ${{ !inputs.dry_run }}
uses: actions/upload-pages-artifact@v3
with:
path: site

pages:
needs: release
if: ${{ !inputs.dry_run && needs.release.result == 'success' }}
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
14 changes: 8 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,12 +9,14 @@ The directory is the control plane:
| EU | [`eu/ip-ranges.json`](eu/ip-ranges.json) |
| US | [`us/ip-ranges.json`](us/ip-ranges.json) |

Each [GitHub Release](https://github.com/truefoundry/nat-ips/releases) attaches the same lists:
Always-latest URLs are on GitHub Pages:

- https://github.com/truefoundry/nat-ips/releases/latest/download/eu.json
- https://github.com/truefoundry/nat-ips/releases/latest/download/us.json
- https://truefoundry.github.io/ip-ranges/eu.json
- https://truefoundry.github.io/ip-ranges/us.json

Replace `.json` with `.txt` for one CIDR per line. Pin a release by replacing `latest/download` with `download/v2026.10.12`.
Replace `.json` with `.txt` for one CIDR per line.

Each [GitHub Release](https://github.com/truefoundry/ip-ranges/releases) attaches the same lists, so a version can be pinned: `https://github.com/truefoundry/ip-ranges/releases/download/v2026.10.12/eu.json`.

## What to allowlist

Expand Down Expand Up @@ -67,9 +69,9 @@ When an address is removed, a new release is published. Drop it from your allowl
To be notified, choose **Watch → Custom → Releases** on this repository, or subscribe to:

```
https://github.com/truefoundry/nat-ips/releases.atom
https://github.com/truefoundry/ip-ranges/releases.atom
```

## Reporting a problem

Something wrong or missing? [Open an issue](https://github.com/truefoundry/nat-ips/issues) or contact TrueFoundry support. For anything security-sensitive, email security@truefoundry.com.
Something wrong or missing? [Open an issue](https://github.com/truefoundry/ip-ranges/issues) or contact TrueFoundry support. For anything security-sensitive, email security@truefoundry.com.
Loading