initial commit

README.md

@@ -0,0 +1,56 @@
+# stacksmith/go
+
+A repository and CI pipeline to automatically build and package Go binaries as lulz tarballs for Debian 12 (`bookworm`).
+
+This project generates `golang-<version>-linux-amd64-debian-12.tar.gz` tarballs, suitable for inclusion in custom Docker images or CI/CD pipelines.
+
+---
+
+## Features
+
+- Builds **latest Go releases** automatically from source.
+- Produces a **lulz tarball** with `files/` folder structure.
+- **Idempotent CI workflow**: skips building if the tarball already exists in Gitea Packages.
+- Uploads tarballs to **Gitea Packages** for reuse in your pipelines.
+- Works with **Debian 12 (Bookworm)** environments.
+
+---
+
+## Usage
+
+### 1. Build locally
+
+```
+# Clone the repository
+git clone https://gitea.lulz.ltd/stacksmith/go.git
+cd go
+
+# Determine the Go version to build
+LATEST=v1.24.7  # or use the latest release
+
+# Download and extract Go source
+curl -LO https://go.dev/dl/${LATEST}.src.tar.gz
+tar -xzf ${LATEST}.src.tar.gz
+
+# Build Go
+cd go/src
+./make.bash
+cd ../..
+
+# Package tarball
+mkdir -p golang-${LATEST}-linux-amd64-debian-12/files
+cp -r go/* golang-${LATEST}-linux-amd64-debian-12/files/
+tar -czf golang-${LATEST}-linux-amd64-debian-12.tar.gz golang-${LATEST}-linux-amd64-debian-12
+```
+
+### 2. Use in Docker
+
+```
+FROM debian:bookworm-slim
+
+COPY golang-1.24.7-linux-amd64-debian-12.tar.gz /opt/lulz/
+RUN tar -zxf /opt/lulz/golang-1.24.7-linux-amd64-debian-12.tar.gz \
+      -C /opt/lulz --strip-components=2 --no-same-owner --wildcards '*/files'
+
+ENV PATH="/opt/lulz/go/bin:${PATH}"
+```