Update installation instructions in README.md to reference the latest release and enhance release process documentation in RELEASE.md to include GoReleaser details. Modify GitHub Actions workflow to utilize GoReleaser for automated releases.

deviantony · deviantony · commit 3b3c90efbc61 · 2025-10-20T14:28:52.000Z
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -23,112 +23,11 @@ jobs:
         with:
           go-version: '1.25'
 
-      - name: Download dependencies
-        run: |
-          go mod download
-          go mod tidy
-
-      - name: Extract version from tag
-        id: version
-        run: |
-          # Remove 'v' prefix from tag name
-          VERSION=${GITHUB_REF#refs/tags/v}
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "tag=$GITHUB_REF_NAME" >> $GITHUB_OUTPUT
-
-      - name: Build binaries
-        run: |
-          # Set version for build
-          export VERSION=${{ steps.version.outputs.version }}
-          make build-all
-
-      - name: Create checksums
-        run: |
-          cd build
-          sha256sum pctl-* > checksums.txt
-          cat checksums.txt
-
-      - name: Generate release notes
-        id: release_notes
-        run: |
-          # Get the previous tag for changelog
-          PREVIOUS_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
-          
-          if [ -n "$PREVIOUS_TAG" ]; then
-            echo "Generating release notes from $PREVIOUS_TAG to ${{ steps.version.outputs.tag }}"
-            echo "## What's Changed" > release_notes.md
-            echo "" >> release_notes.md
-            
-            # Get commits between tags
-            git log --pretty=format:"- %s (%h)" $PREVIOUS_TAG..HEAD >> release_notes.md
-            echo "" >> release_notes.md
-            echo "**Full Changelog**: https://github.com/${{ github.repository }}/compare/$PREVIOUS_TAG...${{ steps.version.outputs.tag }}" >> release_notes.md
-          else
-            echo "No previous tag found, creating initial release notes"
-            echo "## Initial Release" > release_notes.md
-            echo "" >> release_notes.md
-            echo "First release of pctl - Dev Companion for Portainer" >> release_notes.md
-          fi
-          
-          # Add installation instructions
-          cat >> release_notes.md << 'EOF'
-          
-          ## Installation
-          
-          Download the appropriate binary for your platform:
-          
-          ### Linux
-          ```bash
-          # AMD64
-          wget https://github.com/${{ github.repository }}/releases/download/${{ steps.version.outputs.tag }}/pctl-${{ steps.version.outputs.version }}-linux-amd64
-          chmod +x pctl-${{ steps.version.outputs.version }}-linux-amd64
-          sudo mv pctl-${{ steps.version.outputs.version }}-linux-amd64 /usr/local/bin/pctl
-          
-          # ARM64
-          wget https://github.com/${{ github.repository }}/releases/download/${{ steps.version.outputs.tag }}/pctl-${{ steps.version.outputs.version }}-linux-arm64
-          chmod +x pctl-${{ steps.version.outputs.version }}-linux-arm64
-          sudo mv pctl-${{ steps.version.outputs.version }}-linux-arm64 /usr/local/bin/pctl
-          ```
-          
-          ### macOS
-          ```bash
-          # AMD64
-          wget https://github.com/${{ github.repository }}/releases/download/${{ steps.version.outputs.tag }}/pctl-${{ steps.version.outputs.version }}-darwin-amd64
-          chmod +x pctl-${{ steps.version.outputs.version }}-darwin-amd64
-          sudo mv pctl-${{ steps.version.outputs.version }}-darwin-amd64 /usr/local/bin/pctl
-          
-          # ARM64 (Apple Silicon)
-          wget https://github.com/${{ github.repository }}/releases/download/${{ steps.version.outputs.tag }}/pctl-${{ steps.version.outputs.version }}-darwin-arm64
-          chmod +x pctl-${{ steps.version.outputs.version }}-darwin-arm64
-          sudo mv pctl-${{ steps.version.outputs.version }}-darwin-arm64 /usr/local/bin/pctl
-          ```
-          
-          ### Windows
-          ```bash
-          # AMD64
-          wget https://github.com/${{ github.repository }}/releases/download/${{ steps.version.outputs.tag }}/pctl-${{ steps.version.outputs.version }}-windows-amd64.exe
-          # Move pctl-${{ steps.version.outputs.version }}-windows-amd64.exe to your PATH and rename to pctl.exe
-          ```
-          
-          ### Verify Installation
-          ```bash
-          pctl version
-          ```
-          EOF
-          
-          # Output the release notes
-          cat release_notes.md
-
-      - name: Create Release
-        uses: softprops/action-gh-release@v1
+      - name: Run GoReleaser
+        uses: goreleaser/goreleaser-action@v5
         with:
-          tag_name: ${{ steps.version.outputs.tag }}
-          name: Release ${{ steps.version.outputs.tag }}
-          body_path: release_notes.md
-          files: |
-            build/pctl-*
-            build/checksums.txt
-          draft: false
-          prerelease: false
+          distribution: goreleaser
+          version: latest
+          args: release --clean
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.goreleaser.yml b/.goreleaser.yml
@@ -0,0 +1,74 @@
+# GoReleaser configuration for pctl
+# See https://goreleaser.com/ for more information
+
+# Project name and metadata
+project_name: pctl
+
+# Build configuration
+builds:
+  - id: pctl
+    main: .
+    binary: pctl
+    goos:
+      - linux
+      - darwin
+      - windows
+    goarch:
+      - amd64
+      - arm64
+    ldflags:
+      - -s -w
+      - -X github.com/deviantony/pctl/cmd/version.Version={{.Version}}
+      - -X github.com/deviantony/pctl/cmd/version.Commit={{.Commit}}
+      - -X github.com/deviantony/pctl/cmd/version.BuildTime={{.Date}}
+    env:
+      - CGO_ENABLED=0
+
+# Archive configuration
+archives:
+  - id: pctl
+    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+    format_overrides:
+      - goos: windows
+        format: zip
+    files:
+      - README.md
+      - LICENSE
+      - REQUIREMENTS.md
+    format: tar.gz
+
+# Checksums
+checksum:
+  name_template: 'checksums.txt'
+  algorithm: sha256
+
+# Release configuration
+release:
+  github:
+    owner: deviantony
+    name: pctl
+  draft: false
+  prerelease: auto
+  mode: replace
+  name_template: "Release {{ .Tag }}"
+  header: |
+    ## What's Changed
+    
+    {{ range .Commits -}}
+    - {{ .Subject }} ({{ .Hash.Short }})
+    {{ end }}
+    
+    **Full Changelog**: https://github.com/{{ .Repo }}/compare/{{ .PreviousTag }}...{{ .Tag }}
+
+# Changelog configuration
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - '^docs:'
+      - '^test:'
+      - '^ci:'
+      - '^build:'
+      - '^chore:'
+
+# No additional package managers configured
diff --git a/README.md b/README.md
@@ -140,46 +140,50 @@ When you run `pctl deploy`, it will:
 
 ## Installation
 
-Download the latest release for your platform from [GitHub Releases](https://github.com/deviantony/pctl/releases/tag/v1.1.1):
+Download the latest release for your platform from [GitHub Releases](https://github.com/deviantony/pctl/releases/latest):
 
 ### Linux
 ```bash
 # AMD64
-wget https://github.com/deviantony/pctl/releases/download/v1.1.1/pctl_1.1.1_linux_amd64
-chmod +x pctl_1.1.1_linux_amd64
-sudo mv pctl_1.1.1_linux_amd64 /usr/local/bin/pctl
+wget https://github.com/deviantony/pctl/releases/latest/download/pctl_1.2.0_linux_amd64.tar.gz
+tar -xzf pctl_1.2.0_linux_amd64.tar.gz
+chmod +x pctl
+sudo mv pctl /usr/local/bin/
 
 # ARM64
-wget https://github.com/deviantony/pctl/releases/download/v1.1.1/pctl_1.1.1_linux_arm64
-chmod +x pctl_1.1.1_linux_arm64
-sudo mv pctl_1.1.1_linux_arm64 /usr/local/bin/pctl
+wget https://github.com/deviantony/pctl/releases/latest/download/pctl_1.2.0_linux_arm64.tar.gz
+tar -xzf pctl_1.2.0_linux_arm64.tar.gz
+chmod +x pctl
+sudo mv pctl /usr/local/bin/
 ```
 
 ### macOS
 ```bash
 # AMD64
-wget https://github.com/deviantony/pctl/releases/download/v1.1.1/pctl_1.1.1_darwin_amd64
-chmod +x pctl_1.1.1_darwin_amd64
-sudo mv pctl_1.1.1_darwin_amd64 /usr/local/bin/pctl
+wget https://github.com/deviantony/pctl/releases/latest/download/pctl_1.2.0_darwin_amd64.tar.gz
+tar -xzf pctl_1.2.0_darwin_amd64.tar.gz
+chmod +x pctl
+sudo mv pctl /usr/local/bin/
 
 # ARM64 (Apple Silicon)
-wget https://github.com/deviantony/pctl/releases/download/v1.1.1/pctl_1.1.1_darwin_arm64
-chmod +x pctl_1.1.1_darwin_arm64
-sudo mv pctl_1.1.1_darwin_arm64 /usr/local/bin/pctl
+wget https://github.com/deviantony/pctl/releases/latest/download/pctl_1.2.0_darwin_arm64.tar.gz
+tar -xzf pctl_1.2.0_darwin_arm64.tar.gz
+chmod +x pctl
+sudo mv pctl /usr/local/bin/
 ```
 
 ### Windows
 ```bash
 # AMD64
-wget https://github.com/deviantony/pctl/releases/download/v1.1.1/pctl_1.1.1_windows_amd64.exe
-# Move pctl_1.1.1_windows_amd64.exe to your PATH and rename to pctl.exe
+wget https://github.com/deviantony/pctl/releases/latest/download/pctl_1.2.0_windows_amd64.zip
+# Extract the zip file and move pctl.exe to your PATH
 ```
 
 ## Development
 
 ### Creating Releases
 
-Releases are automated using GitHub Actions. To create a new release:
+Releases are automated using [GoReleaser](https://goreleaser.com/) and GitHub Actions. To create a new release:
 
 ```bash
 # Create a new release (e.g., version 1.2.0)
@@ -192,8 +196,8 @@ Releases are automated using GitHub Actions. To create a new release:
 This will:
 1. Create a git tag `v1.2.0`
 2. Push the tag to GitHub
-3. Automatically build binaries for all platforms
-4. Create a GitHub release with all binaries and release notes
+3. GoReleaser automatically builds binaries for all platforms
+4. Creates a GitHub release with all binaries, checksums, and release notes
 
 See [RELEASE.md](RELEASE.md) for detailed release process documentation.
 
diff --git a/RELEASE.md b/RELEASE.md
@@ -1,6 +1,6 @@
 # Release Process
 
-This document explains how to create new releases for pctl using the automated GitHub Actions workflow.
+This document explains how to create new releases for pctl using [GoReleaser](https://goreleaser.com/) and automated GitHub Actions.
 
 ## Quick Start
 
@@ -13,7 +13,7 @@ To create a new release, simply run:
 This will:
 1. Create a git tag `v1.2.0`
 2. Push the tag to GitHub
-3. Trigger the automated release workflow
+3. Trigger the automated GoReleaser workflow
 4. Build binaries for all platforms
 5. Create a GitHub release with all binaries and release notes
 
@@ -25,24 +25,24 @@ This will:
 
 ## Release Workflow
 
-The automated release process includes:
+The automated release process uses [GoReleaser](https://goreleaser.com/) and includes:
 
 ### 1. Build Process
-- Builds binaries for multiple platforms:
-  - Linux AMD64 (`pctl-linux-amd64`)
-  - Linux ARM64 (`pctl-linux-arm64`)
-  - macOS AMD64 (`pctl-darwin-amd64`)
-  - macOS ARM64 (`pctl-darwin-arm64`)
-  - Windows AMD64 (`pctl-windows-amd64.exe`)
+GoReleaser builds binaries for multiple platforms:
+- Linux AMD64 (`pctl_linux_amd64`)
+- Linux ARM64 (`pctl_linux_arm64`)
+- macOS AMD64 (`pctl_darwin_amd64`)
+- macOS ARM64 (`pctl_darwin_arm64`)
+- Windows AMD64 (`pctl_windows_amd64.exe`)
 
 ### 2. Release Creation
 - Creates a GitHub release with the tag name
 - Generates automatic release notes from git commits
-- Uploads all built binaries
-- Creates and uploads checksums file
+- Uploads all built binaries and archives
+- Creates and uploads SHA256 checksums
 
 ### 3. Release Notes
-The workflow automatically generates release notes including:
+GoReleaser automatically generates release notes including:
 - List of commits since the last release
 - Installation instructions for all platforms
 - Link to the full changelog
