Add install_ddev_head.sh script

docs/content/developers/building-contributing.md

@@ -9,7 +9,14 @@ search:
 There are several ways to use DDEV’s latest-committed HEAD version:
 
 * **Download** the latest master branch artifacts from [nightly.link](https://nightly.link/ddev/ddev/workflows/master-build/master). Each of these is built by the CI system, signed, and notarized. Get the one you need and place it in your `$PATH`.
-* **Homebrew install HEAD**: On macOS and Linux, run `brew unlink ddev && brew install ddev/ddev/ddev --HEAD --fetch-HEAD` to get the latest DDEV commit, even if it’s unreleased. Since you’re building this on your own computer, it’s not signed or notarized, and you’ll get a notification that instrumentation doesn’t work, which is fine. If you’re using Linux/WSL2, you’ll likely need to install build-essential by running the following command: `sudo apt-get install -y build-essential`. In case you want to regularly test and use the latest version of DDEV HEAD run `brew upgrade --fetch-head ddev` instead.
+* **Homebrew install HEAD**: On macOS and Linux, run `brew unlink ddev && brew install ddev/ddev/ddev --HEAD --fetch-HEAD` to get the latest DDEV commit, even if it’s unreleased.
+* **Install via script**: You can download and run the [install_ddev_head.sh](https://raw.githubusercontent.com/ddev/ddev/refs/heads/master/scripts/install_ddev_head.sh)  script, or run it automatically:
+
+    ```bash
+    # Download and run the install script
+    curl -fsSL https://raw.githubusercontent.com/ddev/ddev/refs/heads/master/scripts/install_ddev_head.sh | bash
+    ```
+
 * **Build manually**: If you have normal build tools like `make` and `go` installed, you can check out the code and run `make`.
 * **Gitpod** You can use the latest build by visiting DDEV on [Gitpod](https://gitpod.io/#https://github.com/ddev/ddev).
 

scripts/install_ddev_head.sh

@@ -0,0 +1,120 @@
+#!/usr/bin/env bash
+
+#ddev-generated
+# Script to download and install DDEV HEAD build from GitHub Actions artifacts
+# Usage: install_ddev_head.sh
+
+set -o errexit
+set -o pipefail
+set -o nounset
+
+if [ ! -d /usr/local/bin ]; then echo 'using sudo to mkdir missing /usr/local/bin' && sudo mkdir -p /usr/local/bin; fi
+
+GITHUB_OWNER=${GITHUB_OWNER:-ddev}
+ARTIFACTS="ddev"
+TMPDIR=/tmp
+
+RED='\033[31m'
+GREEN='\033[32m'
+YELLOW='\033[33m'
+RESET='\033[0m'
+OS=$(uname)
+BINOWNER=$(ls -ld /usr/local/bin | awk '{print $3}')
+USER=$(whoami)
+SHACMD=""
+FILEBASE=""
+
+if [[ $EUID -eq 0 ]]; then
+  echo "This script must NOT be run with sudo/root. Please re-run without sudo." 1>&2
+  exit 102
+fi
+
+unamearch=$(uname -m)
+case ${unamearch} in
+  x86_64) ARCH="amd64";
+  ;;
+  aarch64) ARCH="arm64";
+  ;;
+  arm64) ARCH="arm64"
+  ;;
+  *) printf "${RED}Sorry, your machine architecture ${unamearch} is not currently supported.\n${RESET}" && exit 106
+  ;;
+esac
+
+if [[ "$OS" == "Darwin" ]]; then
+    SHACMD="shasum -a 256"
+    OS="darwin"
+elif [[ "$OS" == "Linux" ]]; then
+    SHACMD="sha256sum"
+    OS="linux"
+else
+    printf "${RED}Sorry, this installer does not support your platform at this time.${RESET}\n"
+    exit 1
+fi
+
+if ! docker --version >/dev/null 2>&1; then
+    printf "${YELLOW}A docker provider is required for ddev. Please see https://ddev.readthedocs.io/en/stable/users/install/docker-installation/.${RESET}\n"
+fi
+
+ARTIFACTS_URL="https://nightly.link/${GITHUB_OWNER}/ddev/workflows/master-build/master/ddev-head-artifacts.zip"
+printf "${GREEN}Downloading latest HEAD build from GitHub Actions...${RESET}\n"
+
+cd ${TMPDIR}
+curl -fsSL "$ARTIFACTS_URL" -o ddev-head-artifacts.zip || (printf "${RED}Failed downloading $ARTIFACTS_URL${RESET}\n" && exit 108)
+
+printf "${GREEN}Extracting artifacts...${RESET}\n"
+unzip -o ddev-head-artifacts.zip
+
+# Verify checksums
+${SHACMD} -c checksums.txt || (printf "${RED}Checksum verification failed${RESET}\n" && exit 109)
+
+# Extract the OS/arch specific archive
+INNER_ARCHIVE="ddev_${OS}_${ARCH}.zip"
+unzip -o ${INNER_ARCHIVE}
+
+printf "${GREEN}Download verified. Ready to place ddev in your /usr/local/bin.${RESET}\n"
+
+if command -v brew >/dev/null && brew info ddev >/dev/null 2>/dev/null ; then
+  echo "Attempting to unlink any homebrew-installed ddev with 'brew unlink ddev'"
+  brew unlink ddev >/dev/null 2>&1 || true
+fi
+
+if [ -L /usr/local/bin/ddev ] ; then
+    printf "${RED}ddev already exists as a link in /usr/local/bin/ddev. Was it installed with homebrew?${RESET}\n"
+    printf "${RED}Cowardly refusing to install over existing symlink${RESET}\n"
+    exit 101
+fi
+
+SUDO=""
+if [[ "$BINOWNER" != "$USER" ]]; then
+  SUDO=sudo
+fi
+
+if [ ! -z "${SUDO}" ]; then
+    printf "${YELLOW}Running \"sudo mv ddev /usr/local/bin/\" Please enter your password if prompted.${RESET}\n"
+fi
+
+chmod +x ddev
+${SUDO} mv ddev /usr/local/bin/
+
+# Install completions if available
+if command -v brew >/dev/null ; then
+    if [ -d "$(brew --prefix)/etc/bash_completion.d" ]; then
+        bash_completion_dir=$(brew --prefix)/etc/bash_completion.d
+        cp ddev_bash_completion.sh $bash_completion_dir/ddev
+        printf "${GREEN}Installed ddev bash completions in $bash_completion_dir${RESET}\n"
+    fi
+
+    if [ -d "$(brew --prefix)/share/zsh-completions" ] && [ -f ddev_zsh_completion.sh ]; then
+        zsh_completion_dir=$(brew --prefix)/share/zsh-completions
+        cp ddev_zsh_completion.sh $zsh_completion_dir/_ddev
+        printf "${GREEN}Installed ddev zsh completions in $zsh_completion_dir${RESET}\n"
+    fi
+fi
+
+# Cleanup
+rm -f ddev-head-artifacts.zip ${INNER_ARCHIVE} checksums.txt ddev_*_completion.sh
+
+hash -r
+
+printf "${GREEN}ddev HEAD build is now installed. Run \"ddev\" and \"ddev --version\" to verify your installation and see usage.${RESET}\n"