HariSekhon/DevOps-Bash-tools

git.io/bash-tools

1200+ DevOps Shell Scripts and Advanced Bash environment.

Fast, Advanced Systems Engineering, Automation, APIs, shorter CLIs, etc.

Heavily used in many GitHub repos, dozens of DockerHub builds (Dockerfiles) and 600+ CI builds.

• Scripts for many popular DevOps technologies, see Index below for more details
• Advanced configs for common tools like Git, vim, screen, tmux, PostgreSQL psql etc...
• CI configs for most major Continuous Integration products (see CI builds page)
• CI scripts for a drop-in framework of standard checks to run in all CI builds, CI detection, accounting for installation differences across CI environments, root vs user, virtualenvs etc.
• API scripts auto-handling authentication, tokens and other details to quickly query popular APIs with a few keystrokes just supplying the /path/endpoint
• Advanced Bash environment - .bashrc + .bash.d/*.sh - aliases, functions, colouring, dynamic Git & shell behaviour enhancements, automatic pathing for installations and major languages like Python, Perl, Ruby, NodeJS, Golang across Linux distributions and Mac. See .bash.d/README.md
• Installs the best systems packages - AWS CLI, Azure CLI, GCloud SDK, Digital Ocean CLI, Terraform, Terragrunt, GitHub CLI, Kubernetes kubectl & kustomize, Helm, eksctl, Docker-Compose, jq and many others... extensive package lists for servers and desktops for most major Linux distributions package managers and Mac
  • install/ - contains many installation scripts for popular open source software and direct binary downloads from GitHub releases
  • configs/ - contains many dot configs for common technologies like ViM, top, Screen, Tmux, MySQL, PostgreSQL etc.
  • setup/ - contains setup scripts, package lists, extra configs, Mac OS X settings etc.
• Utility Libraries used by many hundreds of scripts and builds across repos:
  • .bash.d/ - interactive library
  • lib/ - scripting and CI library
• SQL Scripts - 100+ scripts for PostgreSQL, MySQL, AWS Athena + CloudTrail, Google BigQuery
• Templates - templates for common programming languages and build configs
• Kubernetes Configs - Kubernetes YAML configs for most common scenarios, including Production Best Practices, Tips & Tricks

See Also: similar DevOps repos in other languages

Hari Sekhon

Cloud & Big Data Contractor, United Kingdom

(ex-Cloudera, former Hortonworks Consultant)

(you're welcome to connect with me on LinkedIn)

To bootstrap, install packages and link in to your shell profile to inherit all configs, do:

curl -L https://git.io/bash-bootstrap | sh

• Adds sourcing to .bashrc/.bash_profile to automatically inherit all .bash.d/*.sh environment enhancements for all technologies (see Inventory below)
• Symlinks .* config dotfiles to $HOME for git, vim, top, htop, screen, tmux, editorconfig, Ansible, PostgreSQL .psqlrc etc. (only when they don't already exist so there is no conflict with your own configs)
• Installs OS package dependencies for all scripts (detects the OS and installs the right RPMs, Debs, Apk or Mac HomeBrew packages)
• Installs Python packages
• Installs AWS CLI

To only install package dependencies to run scripts, simply cd to the git clone directory and run make:

git clone https://github.com/HariSekhon/DevOps-Bash-tools bash-tools
cd bash-tools
make

make install sets your shell profile to source this repo. See Individual Setup Parts below for more install/uninstall options.

• Dot Configs - .gitconfig, .vimrc, .screenrc, .tmux.conf, .toprc, .gitignore...
• Bash Environment & Libraries - .bashrc, .bash.d/ interactive library, lib/ scripting library
• Installation Scripts for many popular open source technologies
• Linux & Mac - curl OAuth / JWT, LDAP, find duplicate files, SSL certificate get/validate, URL encoding/decoding, Vagrant
• Mac & AppleScript - Mac settings and UI automation scripts, send keystrokes, mouse clicks, detect foreground app, switch app, detect locked screen or screensaver, activate screensaver, Hammerspoon system event handlers such as automatically switching audio to be able to Shazam while watching on AirPods
• Monitoring - Grafana, Prometheus, Node Exporter, scripted collection of common Linux & Mac cli monitoring stats and log locations for quick generation of vendor support tarball bundles both locally and over SSH
• AWS - Amazon Web Services - AWS account summary, lots of IAM reports, CIS Benchmark config hardening, EC2, ECR, EKS, Spot termination, S3 access logging, KMS key rotation info, SSM, CloudTrail, CloudWatch billing alarm with SNS notification topic and subscription for email alerts
• GCP - Google Cloud Platform - massive GCP auto-inventory, scripts for GCE, GKE, GCR, Secret Manager, BigQuery, Cloud SQL, Cloud Scheduler, Terraform service account creation
• Kubernetes - massive Kubernetes auto-inventory, cluster management scripts & tricks
• Docker - Docker API, Dockerhub API, Quay.io API scripts
• Databases - fast CLI wrappers, instant Docker sandboxes (PostgreSQL, MySQL, MariaDB, SQLite), SQL scripts, SQL script testers against all versions of a DB, advanced .psqlrc
• Data - data tools, converters and format validators for Avro, Parquet, CSV, JSON, INI / Properties files (Java), LDAP LDIF, XML, YAML
• Big Data & NoSQL - Kafka, Hadoop, HDFS, Hive, Impala, ZooKeeper, Cloudera Manager API & Cloudera Navigator API scripts
• Git - GitHub, GitLab, Bitbucket, Azure DevOps - scripts for Git local & mirror management, GitHub, GitLab & BitBucket APIs
• Markdown - generate Markdown indexes and debug mdl issues like MD005 inconsistent list indentation in large README.md files
• CI/CD - Continuous Integration / Continuous Delivery - API scripts & build pipeline configs for most major CI systems:
  • Jenkins, Concourse, GoCD, TeamCity - one-touch boot & build
  • Azure DevOps Pipelines, GitHub Actions Workflows, GitLab CI, BitBucket Pipelines, AppVeyor, BuildKite, Travis CI, Circle CI, Codefresh, CodeShip, Drone.io, Semaphore CI, Shippable ...
  • Terraform Cloud, Octopus Deploy
  • Checkov / Bridgecrew Cloud
• AI & IPaaS - OpenAI (ChatGPT), Make.com
• Internet Services - Google Maps, Cloudflare, DataDog, Digital Ocean, Kong API Gateway, GitGuardian, Jira, NGrok, Traefik, Pingdom, Wordpress and various pastebins and file upload sites
• Java - Java utilies to debug running Java programs or decompile Java JAR code for deeper debugging
• Python - Python utilities & library management
• Perl - Perl utilities & library management
• Golang - Golang utilities
• Diagrams - scripts to generate diagrams from D2lang, MermaidJS and Python Mingrammer source code used in my HariSekhon/Diagrams-as-Code repo
• Media - video downloaders & converts, MP3 metadata editing, grouping and ordering of albums and audiobooks, mkv/avi to mp4 converters, 720p video downscaler for posting to social media, download YouTube videos or even entire channels and videos from other social media sites like Twitter / X or Facebook, terminal gif capture
• Spotify - 40+ Spotify API scripts for backups, managing playlists, track deduplication, URI conversion, search, add/delete, liked tracks, followed artists, top artists, top tracks etc.
• More Linux & Mac - more systems administration scripts, package installation automation
• Builds, Languages & Linting - programming language, build system & CI linting
• Templates - Templates for AWS, GCP, Terraform, Docker, Jenkins, Cloud Build, Vagrant, Puppet, Python, Bash, Go, Perl, Java, Scala, Groovy, Maven, SBT, Gradle, Make, GitHub Actions, CircleCI, Jenkinsfile, Makefile, Dockerfile, docker-compose.yml etc.
• Kubernetes Configs - Kubernetes YAML configs for most common scenarios, including Production Best Practices, Tips & Tricks

Top-level dotfiles and configs/ directory:

• .* - dot conf files for lots of common software eg. advanced .vimrc, .gitconfig, massive .gitignore, .editorconfig, .screenrc, .tmux.conf etc.
  • .vimrc - contains many awesome vim tweaks, plus hotkeys for linting lots of different file types in place, including Python, Perl, Bash / Shell, Dockerfiles, JSON, YAML, XML, CSV, INI / Properties files, LDAP LDIF etc without leaving the editor!
  • .screenrc - fancy screen configuration including advanced colour bar, large history, hotkey reloading, auto-blanking etc.
  • .tmux.conf - fancy tmux configuration include advanced colour bar and plugins, settings, hotkey reloading etc.
  • Git:
    • .gitconfig - advanced Git configuration
    • .gitignore - extensive Git ignore of trivial files you shouldn't commit
    • enhanced Git diffs
    • protections against committing AWS secret keys or merge conflict unresolved files

Top-level .bashrc and .bash.d/ directory:

• .bashrc - shell tuning and sourcing of .bash.d/*.sh
• .bash.d/*.sh - thousands of lines of advanced bashrc code, aliases, functions and environment variables for:
  • Linux & Mac
  • SCM - Git, Mercurial, Svn
  • AWS
  • GCP
  • Docker
  • Kubernetes
  • Kafka
  • Vagrant
  • automatic GPG and SSH agent handling for handling encrypted private keys without re-entering passwords, and lazy evaluation to only prompt key load the first time SSH is called
  • and lots more - see .bash.d/README for a more detailed list
  • run make bash to link .bashrc/.bash_profile and the .* dot config files to your $HOME directory to auto-inherit everything
• lib/*.sh - Bash utility libraries full of functions for Docker, environment, CI detection (Travis CI, Jenkins etc), port and HTTP url availability content checks etc. Sourced from all my other GitHub repos to make setting up Dockerized tests easier.

• install/install_*.sh - various simple to use installation scripts for common technologies like:
  • AWS CLI
  • Azure CLI
  • GCloud SDK
  • GitHub CLI
  • Terraform
  • Terragrunt
  • Direnv
  • Ansible
  • K3s
  • MiniKube (Kubernetes)
  • MiniShift (Redhat OpenShift / OKD dev VMs)
  • Maven
  • Gradle
  • SBT
  • EPEL
  • RPMforge
  • Homebrew
  • Travis CI
  • Circle CI
  • AppVeyor
  • BuildKite
  • Avro Tools
  • Parquet Tools
  • Prometheus
  • various JDKs and RDBMS JDBC connector jars
  • and many more...

bin/ directory:

• login.sh - logs to major Cloud platforms if their credentials are found in the environment, CLIs such as AWS, GCP, Azure, GitHub... Docker registries: DockerHub, GHCR, ECR, GCR, GAR, ACR, Gitlab, Quay...
• clean_caches.sh - cleans out OS package and programming language caches - useful to save space or reduce Docker image size
• command_return_to_current_window.sh - runs a Mac or Linux command that opens a window and then switches back to the original foreground window
• crypto_dice_rolls.sh - generates 100 random dice rolls to test a new crypto hardware wallet's fidelity (do not use this for your real crypto seed as your machine could be infected with malware which steals your seed phrase)
• delete_duplicate_files.sh - deletes duplicate files with (N) suffixes, commonly caused by web browser downloads, in the given or current directory. Checks they're exact duplicates of a matching basename file without the (N) suffix with the exact same checksum for safety. Prompts to delete per file. To auto-accept deletions, do yes | delete_duplicate_files.sh. This is a fast way of cleaning up your ~/Downloads directory and can be put your user crontab
• diff_line_threshold.sh - compares two files vs a line count diff threshold to determine if they are radically different. Used to avoid overwriting files which are not mere updates but completely different files
• disk_speed_read_sequential_dd.sh - runs a sequential read speed test from the given file using dd and bypassing filesystem cache for a more accurate test
• disk_speed_read_random_dd.sh - runs a random I/O read speed test from the given file using dd and bypassing filesystem cache for a more accurate test
• disk_speed_write_sequential_dd.sh - runs a sequential write speed test to a file in the given or current directory using dd and bypassing filesystem cache for a more accurate test
• disk_speed_read_sequential_fio.sh - runs a sequential read speed test in the current or given directory using fio
• disk_speed_read_random_fio.sh - runs a random I/O read test in the current or given directory using fio
• disk_speed_write_sequential_fio.sh - runs a sequential write speed test to the current or given directory using fio
• disk_speed_write_random_fio.sh - runs a sequential write speed test to the current or given directory using fio
• download_url_file.sh - downloads a file from a URL using wget with no clobber and continue support, or curl with atomic replacement to avoid race conditions. Used by github/github_download_release_file.sh, github_download_release_jar.sh, and install/download_*_jar.sh
• curl_auth.sh - shortens curl command by auto-loading your OAuth2 / JWT API token or username & password from environment variables or interactive starred password prompt through a ram file descriptor to avoid placing them on the command line (which would expose your credentials in the process list or OS audit log files). Used by many other adjacent API querying scripts
• curl_with_cookies.sh - extracts cookies for a given URL from your \$BROWSER's cookie jar and passes them to the curl command along with the rest of the args (workaround for older curl builds and Homebrew builds that don't have the newer `--cookies-from-browser functionality)
• emptytrash.sh - empties the Trash portably on Linux and Mac. On Mac, combine with a post-run of mac_delete_local_snapshots.sh to ensure space is reclaimed
• find_duplicate_files_by_*.sh / - finds duplicate files by size and/or checksum in given directory trees. Checksums are only done on files that already have matching byte counts for efficiency
• find_broken_links.sh - find broken links with delays to avoid tripping defenses
• find_broken_symlinks.sh - find broken symlinks pointing to non-existent files/directories
• find_lock.sh - tries to find if a lockfile is used in the given or current working directory by taking snapshots of the file list before and after a prompt in which you should open/close an application
• foreach_path_bin.sh - runs each binary of the given name found in $PATH with the args given. Useful to find all the installed versions of a program in different paths eg. ~/bin/ vs /usr/local/bin/ eg. foreach_path_bin.sh terraform --version
• http_duplicate_urls.sh - find duplicate URLs in a given web page
• htmldecode.sh - decodes HTML encoding. Detects available tools such as Perl, Python or xmlstarlet and uses whatever is available
• html_hrefs.sh - parses href links out of an HTML page given as a file or read from stdin. See also urlextract.sh for a simpler pure bash HTTP(s) URL onlyonly string extractor
• ldapsearch.sh - shortens ldapsearch command by inferring switches from environment variables
• ldap_user_recurse.sh / ldap_group_recurse.sh - recurse Active Directory LDAP users upwards to find all parent groups, or groups downwards to find all nested users (useful for debugging LDAP integration and group-based permissions)
• linux_distro_versions.sh - quickly returns the list of major versions for a given Linux distro
• linux_command_return_to_current_window.sh - runs a Linux command that opens a window and then switches back to the original foreground window
• lockdir.sh - creates a portable atomic lock using a given directory. Useful for a script to prevent two instances from running at the same time to avoid either data corruption or API rate limits. If you're on Linux you should use flock if available for its enhanced kernel integration
• mac_command_return_to_current_window.sh - runs a Mac command that opens a window and then switches back to the original foreground window
• mv.sh - moves directory trees resumably and removes the source files as they're copied over. Useful to migrate data from one disk to another, optionally with checksums. Uses rsync and shows the overall % of files transferred and the MB/s data transfer rate
• network_gateway.sh - get the network gateway IP address on Linux or Mac
• network_randomize_mac_address.sh - assigns a new random mac address to your network interface
• open.sh - opens given arg, file or URL using whatever default system opener is available for Linux or Mac
• organize_downloads.sh - moves files of well-known extensions in the $HOME/Downloads directory older than 1 week to capitalized subdirectories of their type to keep the $HOME/Downloads/ directory tidy
• copy_to_clipboard.sh - copies stdin or string arg to system clipboard on Linux or Mac
• paste_from_clipboard.sh - pastes from system clipboard to stdout on Linux or Mac
• paste_from_clipboard_upon_changes.sh - pastes from system clipboard to stdout on Linux or Mac whenever the clipboard changes
• paste_diff_settings.sh - takes snapshots of before and after clipboard changes and diffs them to show config changes. Useful to figure out how to backport UI generated changes that are exportable to a global Config-as-Code such as in Jenkins JCasC
• processes_ram_sum.sh - sums the RAM usage of all processes matching a given regex in GB to one decimal place
• pldd.sh - parses /proc on Linux to show the runtime .so loaded dynamic shared libraries a program pid is using. Runtime equivalent of the classic static ldd command and because the system pldd command often fails to attach to a process
• random_select.sh - selects one of given args at random. Useful for sampling, running randomized subsets of large test suites etc.
• random_number.sh - prints a random integer between two integer arguments (inclusive)
• random_string.sh - prints a random alphanumeric string of a given length
• screen_terminal_to_stdout.sh - dumps the GNU Screen terminal output to stdout
• screen_terminal_to_clipboard.sh - dumps the GNU Screen terminal output to a temp file and copies to clipboard for sharing & debugging purposes
• shields_embed_logo.sh - base64 encodes a given icon file or url and prints the logo=... url parameter you need to add the shields.io badge url
• shorten_clipboard_text.sh - shortens the text in clipboard to make social media comments shorter. Replaces and with & and crushes out multiple blank lines. I used this for LinkedIn comments due to the short 1250 character limit
• shorten_text_selection.sh - shortens the selected text in the prior window. Faster way to use the above without having to copy and paste clipboard manually
• shred_file.sh - overwrites a file 7 times to DoD standards before deleting it to prevent recovery of sensitive information
• shred_free_space.sh - overwrites free space to prevent recovery of sensitive information for files that have already been deleted
• sleepuntil.sh - sleep until the given HH:MM clock time. Useful for delaying the run of a foreground terminal program to inherit your terminal's environment variables (which may contain API keys) or interactively manage a process in your terminal, which cannot be done with the at command. I use this for my HariSekhon/Spotify-Playlists backup each night so it waits in terminal for me to arrive home and runs it interactively to allow human gate safety approvals before Git committing any song removals from any playlist
• split.sh - split large files into N parts (defaults to the number of your CPU cores) to parallelize operations on them
• ssl_get_cert.sh - gets a remote host:port server's SSL cert in a format you can pipe, save and use locally, for example in Java truststores
• ssl_verify_cert.sh - verifies a remote SSL certificate (battle tested more feature-rich version check_ssl_cert.pl exists in the Advanced Nagios Plugins repo)
• ssl_verify_cert_by_ip.sh - verifies SSL certificates on specific IP addresses, useful to test SSL source addresses for CDNs, such as Cloudflare Proxied sources before enabling SSL Full-Strict Mode for end-to-end, or Kubernetes ingresses (see also curl_k8s_ingress.sh)
• text_filter_ending_substrings.sh - for a given patterns file of substring endings, print all lines that match in the following files. Uses awk to safely handle all characters as literals, unlike grep, while also maintaining end anchoring which you cannot do using grep -F. Optimized awk code uses a bucketing hash for performance to not attempt matching lines which are shorter than patterns, reducing the number of match attempts
• tmux_vertical.sh - launches tmux with N-way vertical shell split or commands given as args in equally balanced vertical panes. Fast way to launch a bunch of shell or commands in an easily reviewable side-by-side way
• tmux_horizontal.sh - same as above but split horizontally
• tmux_square.sh - same as above but with 4 panes in a square tiled view
• urlencode.sh / urldecode.sh - URL encode/decode quickly on the command line, in pipes etc.
• urlextract.sh - extracts the URLs from a given string arg, file or standard input
• url_extract_redirects.sh - extracts the URLs from a given string arg, file or standard input, queries each one and outputs the redirected urls instead to stdout
• url_replace_redirects.sh - extracts the URLs from a given string arg, file or standard input, queries each one and outputs the entire contents to stdout with the urls replaced by the redirected urls
• urlopen.sh - opens the URL given as an arg, or first URL found from stdin or a given file. Uses the system's default browser
• vagrant_hosts.sh - generate /etc/hosts output from a Vagrantfile
• vagrant_total_mb.sh - calculate the RAM committed to VMs in a Vagrantfile

See also Knowledge Base notes for Linux and Mac.

Mac automation scripts to automate the Mac UI and settings

bin/ directory:

• emptytrash.sh - empties the Trash portably on Linux and Mac. On Mac, combine with a post-run of mac_delete_local_snapshots.sh to ensure space is reclaimed
• mac_diff_settings.sh - takes before and after snapshots of UI setting changes and diffs them to make it easy to find defaults keys to add to setup/mac_settings.sh to save settings
• mac_restore_file.sh - checks all the backup mount points for the latest backup that has a given file and then restores it
• mac_backup_du_in_progress.sh - find large files in the currently in-progress Time Machine backup to find out what is taking so long and racking up so many more GB of changes than you expect. This helps discover large but unnecessary files that you might want to exclude using the adjacent script mac_backup_exclude_paths.sh
• mac_backup_exclude_paths.sh - excludes many common large caches, docker and VM paths from macOS Time Machine backups
• mac_backup_find_excluded_paths.sh - does a deep search for macOS Time Machine excluded backup paths on file/folder attributes. See HariSekhon/Knowledge-Base Mac page for why
• mac_command_return_to_current_window.sh - runs a Mac command that opens a window and then switches back to the original foreground window
• mac_rmdir.sh - safely delete a directory on Mac only if it is empty of actual data, by first removing macOS hidden metadata files and dirs such as .fseventsd/, .Spotlight-V100/ and .DS_Store - straight rmdir fails otherwise
• mac_iso_to_usb.sh - converts a given ISO file to a USB bootable image and burns it onto a given or detected inserted USB drive
• mac_ramdisk.sh - creates a mac ramdisk of given MB size. Useful for performance, or even testing disk write scripts such as disk_speed_write_*.sh without wearing out your SSD
• mac_delete_local_snapshots.sh - deletes local macOS snapshots to free up disk space. When there is a substantial discrepancy between what the df -h command and the Finder UI shows, this is often the cause. Recommended to first run emptytrash.sh
• copy_to_clipboard.sh - copies stdin or string arg to system clipboard on Linux or Mac
• paste_from_clipboard.sh - pastes from system clipboard to stdout on Linux or Mac
• paste_from_clipboard_upon_changes.sh - pastes from system clipboard to stdout on Linux or Mac whenever the clipboard changes
• paste_diff_settings.sh - takes snapshots of before and after clipboard changes and diffs them to show config changes. Useful to figure out how to backport UI generated changes that are exportable to a global Config-as-Code such as in Jenkins JCasC

applescript/ directory:

• keystrokes.sh - send N keystroke combinations
• mouse_clicks.sh - send N mouse click combinations to sequence of screen coordinates
  • get_mouse_coordinates.sh - print the current mouse coordinates - to know what to pass to above script
• mouse_clicks_remote_desktop.sh - switches to Microsoft Remote Desktop, waits 10 seconds and then clicks the mouse once a minute to prevent the screensaver from coming on. Workaround to Active Directory Group Policies that don't let you disable the screensaver. Point your mouse to an area that will have no mouse click effect, the Cmd-Tab to Terminal and run this
• get_frontmost_process_title.applescript - detect the frontmost window
  • to detect if you should send keystrokes / mouse clicks)
• set_frontmost_process.applescript - switch to bring the given app to the foreground to send keystrokes / mouse clicks to it
  • browser_get_default.applescript - get the default configured browser in format passable to Applescript (for above script)
• is_screen_locked.py - detect if the screen is locked to stop sending keystrokes or mouse clicks
• is_screensaver_running.applescript - detect if the screensaver is running to stop sending keystrokes or mouse clicks
• reopen_app.sh - relaunch a given app (used to reload Shazam to detect DB changes after removing tracks programmatically from its DB)
• spotify_app_search.sh - runs a search in the Spotify App on Mac using Applescript
• spotify_app_search_filelist.sh - searches the Spotify App for each track in a file, prompting to continue to the next track
• shazam_app_dump_tracks.sh - dumps artist - track one per line from the Shazam local sqlite DB
• shazam_app_delete_track.sh - deletes a given "artist" "track" from the Shazam local sqlite DB
• shazam_search_spotify_then_delete_track.sh - searches for each Shazam'd track in the local Spotify desktop app, then prompts to delete each track from the local Shazam DB once you've saved it in Spotify. Useful to migrate Shazam'd tracks to Spotify after Apple removed the integration
• screensaver_activate.applescript - activate screensaver
• shorten_text_selection.applescript - shortens the selected text in the prior window. Replaces and with & and crushes out multiple blank lines. I use this for LinkedIn comments due to the short 1250 character limit
• start_app_at_login.sh - adds an app to the Login items to auto-start

Hammerspoon code has been moved to its own repo:

See also Mac page in HariSekhon/Knowledge-Base.

monitoring/ directory:

• dump_stats.sh - dumps common command outputs to text files in a local tarball. Useful to collect support information for vendor support cases
• grafana_api.sh - queries the Grafana API with authentication
• log_timestamp_large_intervals.sh - finds log lines whose timestamp intervals exceed the given number of seconds and outputs those log lines with the difference between the last and current timestamps. Useful to find actions that are taking a long time from log files such as CI/CD logs
• prometheus.sh - starts Prometheus locally, downloading it if not found in $PATH
• prometheus_docker.sh - starts Prometheus in Docker using docker-compose
• prometheus_node_exporter.sh - starts Prometheus node_exporter locally, downloading it if not found in $PATH
• ssh_dump_stats.sh - uses SSH and dump_stats.sh to dump common command outputs from remote servers to a local tarball. Useful for vendor support cases
• ssh_dump_logs.sh - Uses SSH to dump logs from server to local text files for uploading to vendor support cases

See doc pages in HariSekhon/Knowledge-Base on Grafana, Prometheus, OpenTSDB, InfluxDB etc.

mysql/, postgres/, sql/ and bin/ directories:

• sql/ - 100+ SQL scripts for PostgreSQL, MySQL, Google BigQuery and AWS Athena CloudTrail logs integration
• sqlite.sh - one-touch SQLite, starts sqlite3 shell with sample 'chinook' database loaded
• mysql*.sh - MySQL scripts:
  • mysql.sh - shortens mysql command to connect to MySQL by auto-populating switches from both standard environment variables like $MYSQL_TCP_PORT, $DBI_USER, $MYSQL_PWD (see doc) and other common environment variables like $MYSQL_HOST / $HOST, $MYSQL_USER / $USER, $MYSQL_PASSWORD / $PASSWORD, $MYSQL_DATABASE / $DATABASE
  • mysql_foreach_table.sh - executes a SQL query against every table, replacing {db} and {table} in each iteration eg. select count(*) from {table}
  • mysql_*.sh - various scripts using mysql.sh for row counts, iterating each table, or outputting clean lists of databases and tables for quick scripting
  • mysqld.sh - one-touch MySQL, boots docker container + drops in to mysql shell, with /sql scripts mounted in container for easy sourcing eg. source /sql/<name>.sql. Optionally loads sample 'chinook' database
  • see also the SQL Scripts repo for many more straight MySQL SQL scripts
• mariadb.sh - one-touch MariaDB, boots docker container + drops in to mysql shell, with /sql scripts mounted in container for easy sourcing eg. source /sql/<name>.sql. Optionally loads sample 'chinook' database
• postgres*.sh / psql.sh - PostgreSQL scripts:
  • postgres.sh - one-touch PostgreSQL, boots docker container + drops in to psql shell, with /sql scripts mounted in container for easy sourcing eg. \i /sql/<name>.sql. Optionally loads sample 'chinook' database
  • psql.sh - shortens psql command to connect to PostreSQL by auto-populating switches from environment variables, using both standard postgres supported environment variables like $PG* (see doc) as well as other common environment variables like $POSTGRESQL_HOST / $POSTGRES_HOST / $HOST, $POSTGRESQL_USER / $POSTGRES_USER / $USER, $POSTGRESQL_PASSWORD / $POSTGRES_PASSWORD / $PASSWORD, $POSTGRESQL_DATABASE / $POSTGRES_DATABASE / $DATABASE
  • postgres_foreach_table.sh - executes a SQL query against every table, replacing {db}, {schema} and {table} in each iteration eg. select count(*) from {table}
  • postgres_*.sh - various scripts using psql.sh for row counts, iterating each table, or outputting clean lists of databases, schemas and tables for quick scripting
  • checks/check_sqlfluff.sh - recursively iterates all SQL code files found in the given or current directory and runs SQLFluff linter against them, inferring the different SQL dialects from each path/filename/extension

aws/ directory:

• AWS scripts - aws_*.sh:
  • aws_profile.sh - switches to an AWS Profile selected from a convenient interactive menu list of AWS profiles from $AWS_CONFIG_FILE - useful when you have lots of AWS work profiles
    • see also HariSekhon/Environments for automated switching using direnv when cding into relevant directories
  • aws_cli_create_credential.sh - creates an AWS service account user for CI/CD or CLI with Admin permissions (or other group or policy), creates an AWS Access Key, saves a credentials CSV and even prints the shell export commands and aws credentials file config to configure your environment to start using it. Useful trick to avoid CLI reauth to aws sso login every day.
  • aws_terraform_create_credential.sh - creates a AWS terraform service account with Administrator permissions for Terraform Cloud or other CI/CD systems to run Terraform plan and apply, since no CI/CD systems can work with AWS SSO workflows. Stores the access key as both CSV and prints shell export commands and credentials file config as above
  • .envrc-aws - copy to .envrc for direnv to auto-load AWS configuration settings such as AWS Profile, Compute Region, EKS cluster kubectl context etc.
    • calls .envrc-kubernetes to set the kubectl context isolated to current shell to prevent race conditions between shells and scripts caused by otherwise naively changing the global ~/.kube/config context
  • aws_sso_ssh.sh - launches local AWS SSO authentication pop-up (if not already authenticated), then scp's the latest resultant ~/.aws/sso/cache/ file to the remote server and SSH's there so that you can use AWS CLI or kubectl to EKS remotely on that server easily, without having to copy and paste the token from remote aws sso login to your local web browser
  • aws_terraform_create_s3_bucket.sh - creates a Terraform S3 bucket for storing the backend state, locks out public access, enables versioning, encryption, and locks out Power Users role and optionally any given user/group/role ARNs via a bucket policy for safety
  • aws_terraform_create_dynamodb_table.sh - creates a Terraform locking table in DynamoDB for use with the S3 backend, plus custom IAM policy which can be applied to less privileged accounts
  • aws_terraform_create_all.sh - runs all of the above, plus also applies the custom DynamoDB IAM policy to the user to ensure if the account is less privileged it can still get the Terraform lock (useful for GitHub Actions environment secret for a read only user to generate Terraform Plans in Pull Request without needing approval)
  • aws_terraform_iam_grant_s3_dynamodb.sh - creates IAM policies to access any S3 buckets and DynamoDB tables with terraform-state or tf-state in their names, and attaches them to the given user. Useful for limited permissions CI/CD accounts that run Terraform Plan eg. in GitHub Actions pull requests
  • aws_account_summary.sh - prints AWS account summary in key = value pairs for easy viewing / grepping of things like AccountMFAEnabled, AccountAccessKeysPresent, useful for checking whether the root account has MFA enabled and no access keys, comparing number of users vs number of MFA devices etc. (see also check_aws_root_account.py in Advanced Nagios Plugins)
  • aws_billing_alarm.sh - creates a CloudWatch billing alarm and SNS topic with subscription to email you when you incur charges above a given threshold. This is often the first thing you want to do on an account
  • aws_budget_alarm.sh - creates an AWS Budgets billing alarm and SNS topic with subscription to email you when both when you start incurring forecasted charges of over 80% of your budget, and 90% actual usage. This is often the first thing you want to do on an account
  • aws_batch_stale_jobs.sh - lists AWS Batch jobs that are older than N hours in a given queue
  • aws_batch_kill_stale_jobs.sh - finds and kills AWS Batch jobs that are older than N hours in a given queue
  • aws_cloudfront_distribution_for_origin.sh - returns the AWS CloudFront ARN of the distribution which serves origins containing a given substring. Useful for quickly finding the CloudFront ARN needed to give permissions to a private S3 bucket exposed via CloudFront
  • aws_cloudtrails_cloudwatch.sh - lists Cloud Trails and their last delivery to CloudWatch Logs (should be recent)
  • aws_cloudtrails_event_selectors.sh - lists Cloud Trails and their event selectors to check each one has at least one event selector
  • aws_cloudtrails_s3_accesslogging.sh - lists Cloud Trails buckets and their Access Logging prefix and target bucket. Checks S3 access logging is enabled
  • aws_cloudtrails_s3_kms.sh - lists Cloud Trails and whether their S3 buckets are KMS secured
  • aws_cloudtrails_status.sh - lists Cloud Trails status - if logging, multi-region and log file validation enabled
  • aws_config_all_types.sh - lists AWS Config recorders, checking all resource types are supported (should be true) and includes global resources (should be true)
  • aws_config_recording.sh - lists AWS Config recorders, their recording status (should be true) and their last status (should be success)
  • aws_csv_creds.sh - prints AWS credentials from a CSV file as shell export statements. Useful to quickly switch your shell to some exported credentials from a service account for testing permissions or pipe to upload to a CI/CD system via an API (eg. jenkins_cred_add*.sh, github_actions_repo*_set_secret.sh, gitlab_*_set_env_vars.sh, circleci_*_set_env_vars.sh, bitbucket_*_set_env_vars.sh, terraform_cloud_*_set_vars.sh, kubectl_kv_to_secret.sh). Supports new user and new access key csv file formats.
  • aws_codecommit_csv_creds.sh - prints AWS CodeCommit Git credentials from a CSV file as shell export statements. Similar use case and chaining as above
  • aws_ec2_*.sh - AWS EC2 scripts:
    • aws_ec2_instance_*.sh - AWS EC2 Instance scripts:
      • aws_ec2_instance_name_to_id.sh - looks up an EC2 instance ID from an instance name with extra safety checks that only a single instance ID is returned and a reverse lookup on that instance ID to re-verify it matches the name. This level of safety is important when wanting to terminate an EC2 instance by name. If an instance ID is passed, returns it as is for convenience. Used by adjacent scripts
      • aws_ec2_instances.sh - lists AWS EC2 instances, their DNS names and States in an easy to read table output
      • aws_ec2_instance_ip.sh - determines an EC2 instance IP address, trying first for a public IP, or failing that a private IP
      • aws_ec2_instance_clone.sh - clones an AWS EC2 instance by creating an AMI from the original and then booting a new instance from the AMI with the same settings as the original instance. Useful to testing risky things on a separate EC2 instance, such as Server Administrator recovery of Tableau
      • aws_ec2_instance_wait_for_ready.sh - polls an AWS EC2 instance and waits for it to finish initializing to a ready state. Used by adjacent scripts
      • aws_ec2_instance_terminate_by_name.sh - terminate an AWS EC2 instance by name for convenience, resolves its instance ID, verifies unique and then terminates by ID
    • aws_ec2_ami*.sh - AWS EC2 AMI scripts:
      • aws_ec2_amis.sh - list AWS EC2 AMIs belonging to your account in an easy to read table output
      • aws_ec2_ami_ids.sh - lists AWS EC2 AMI IDs only, one per line, to be used in adjacent scripts that creating mapping tables and translate AMI IDs to names in inventory scripts aws_info_ec2*.sh
      • aws_ec2_ami_name_to_id.sh - looks up an EC2 AMI ID from a name with extra safety checks that only a single AMI ID is returned and a reverse lookup on that AMI ID to re-verify it matches the name
      • aws_ec2_ami_boot.sh - boots a personal EC2 instance of a given AMI for testing
      • aws_ec2_ami_boot_ssh.sh - boots a personal EC2 instance of a given AMI, determines the public or private IP, and drops you into an SSH shell
      • aws_ec2_ami_create_from_instance.sh - creates an AWS EC2 AMI from an EC2 instance and waits for it to become available for use
      • aws_ec2_ami_share_to_account.sh - shares an AMI with another AWS account. Can specify AMI by name or id
    • aws_ec2_ebs_*.sh - AWS EC2 EBS scripts:
      • aws_ec2_ebs_volumes.sh - list EC2 instances and their EBS volumes in the current region
      • `aws_ec2_ebs_create_snapshot_and_wait.sh - creates a snapshot of a given EBS volume ID and waits for it to complete with exponential backoff
      • `aws_ec2_ebs_resize_and_wait.sh - resizes an EBS volume and waits for it to complete modifying and optionally optimizing with exponential backoff
      • aws_ec2_ebs_volumes_unattached.sh - list an unattached EBS volumes in a table format
    • aws_ec2_launch_templates_ami_id.sh - for each Launch Template lists the AMI ID of the latest version. Useful to check EKS upgrades of node groups via Terragrunt have taken effect
  • aws_ecr_*.sh - AWS ECR docker image management scripts:
    • aws_ecr_docker_login.sh - authenticates Docker to AWS ECR, inferring the ECR registry from the current AWS Account ID and Region
    • aws_ecr_docker_build_push.sh - builds a docker image and pushes it to ECR with not just the latest docker tag but also the current Git hashref and Git tags
    • aws_ecr_list_repos.sh - lists ECR repos, and their docker image mutability and whether image scanning is enabled
    • aws_ecr_list_tags.sh - lists all the tags for a given ECR docker image
    • aws_ecr_newest_image_tags.sh - lists the tags for the given ECR docker image with the newest creation date (can use this to determine which image version to tag as latest)
    • aws_ecr_alternate_tags.sh - lists all the tags for a given ECR docker image:tag (use arg <image>:latest to see what version / build hashref / date tag has been tagged as latest)
    • aws_ecr_tag_image.sh - tags an ECR image with another tag without pulling and pushing it
    • aws_ecr_tag_image_by_digest.sh - same as above but tags an ECR image found via digest (more accurate as reference by existing tag can be a moving target). Useful to recover images that have become untagged
    • aws_ecr_tag_latest.sh - tags a given ECR docker image:tag as latest without pulling or pushing the docker image
    • aws_ecr_tag_branch.sh - tags a given ECR image:tag with the current Git branch without pulling or pushing the docker image
    • aws_ecr_tag_datetime.sh - tags a given ECR docker image with its creation date and UTC timestamp (when it was uploaded to ECR) without pulling or pushing the docker image
    • aws_ecr_tag_newest_image_as_latest.sh - finds and tags the newest build of a given ECR docker image as latest without pulling or pushing the docker image
    • aws_ecr_tags_timestamps.sh - lists all the tags and their timestamps for a given ECR docker image
    • aws_ecr_tags_old.sh - lists tags older than N days for a given ECR docker image
    • aws_ecr_delete_old_tags.sh - deletes tags older than N days for a given ECR docker image. Lists the image:tags to be deleted and prompts for confirmation safety
  • aws_emr_clusters_last_steps.sh - shows the last N steps executed on each EMR cluster and their EndTime to find idle clusters that should be removed. Also checks CloudWatch for number of steps running within the last few months to catch directly submitted jobs such as Spark, Hive, Glue or Athena which won't show up in the native steps list
  • aws_foreach_profile.sh - executes a templated command across all AWS named profiles configured in AWS CLIv2, replacing {profile} in each iteration. Combine with other scripts for powerful functionality, auditing, setup etc. eg. aws_kube_creds.sh to configure kubectl config to all EKS clusters in all environments
  • aws_foreach_region.sh - executes a templated command against each AWS region enabled for the current account, replacing {region} in each iteration. Combine with AWS CLI or scripts to find resources across regions
  • aws_iam_*.sh - AWS IAM scripts:
    • aws_iam_password_policy.sh - prints AWS password policy in key = value pairs for easy viewing / grepping (used by aws_harden_password_policy.sh before and after to show the differences)
    • aws_iam_harden_password_policy.sh - strengthens AWS password policy according to CIS Foundations Benchmark recommendations
    • aws_iam_replace_access_key.sh - replaces the non-current IAM access key (Inactive, Not Used, longer time since used, or an explicitly given key), outputting the new key as shell export statements (useful for piping to the same tools listed for aws_csv_creds.sh above)
    • aws_iam_policies_attached_to_users.sh - finds AWS IAM policies directly attached to users (anti-best practice) instead of groups
    • aws_iam_policies_granting_full_access.sh - finds AWS IAM policies granting full access (anti-best practice)
    • aws_iam_policies_unattached.sh - lists unattached AWS IAM policies
    • aws_iam_policy_attachments.sh - finds all users, groups and roles where a given IAM policy is attached, so that you can remove all these references in your Terraform code and avoid this error Error: error deleting IAM policy arn:aws:iam::***:policy/mypolicy: DeleteConflict: Cannot delete a policy attached to entities.
    • aws_iam_policy_delete.sh - deletes an IAM policy, by first handling all prerequisite steps of deleting all prior versions and all detaching all users, groups and roles
    • aws_iam_generate_credentials_report_wait.sh - generates an AWS IAM credentials report
    • aws_iam_users.sh - list your IAM users
    • aws_iam_users_access_key_age.sh - prints AWS users access key status and age (see also aws_users_access_key_age.py in DevOps Python tools which can filter by age and status)
    • aws_iam_users_access_key_age_report.sh - prints AWS users access key status and age using a bulk credentials report (faster for many users)
    • aws_iam_users_access_key_last_used.sh - prints AWS users access keys last used date
    • aws_iam_users_access_key_last_used_report.sh - same as above using bulk credentials report (faster for many users)
    • aws_iam_users_last_used_report.sh - lists AWS users password/access keys last used dates
    • aws_iam_users_mfa_active_report.sh - lists AWS users password enabled and MFA enabled status
    • aws_iam_users_without_mfa.sh - lists AWS users with password enabled but no MFA
    • aws_iam_users_mfa_serials.sh - lists AWS users MFA serial numbers (differentiates Virtual vs Hardware MFAs)
    • aws_iam_users_pw_last_used.sh - lists AWS users and their password last used date
  • aws_ip_ranges.sh - get all AWS IP ranges for a given Region and/or Service using the IP range API
  • aws_info*.sh:
    • aws_info_all_profiles.sh - calls aws_info.sh for all AWS profiles using aws_foreach_profile.sh
      • aws_info.sh - lists AWS deployed resources in the current or specified AWS account profile
        • aws_info_ec2.sh - lists AWS EC2 Instances resources deployed in the current AWS account
    • aws_info_ec2_csv.sh - lists AWS EC2 Instances in quoted CSV format in the current AWS account
    • aws_info_ec2_all_profiles_csv.sh - lists AWS EC2 Instances in quoted CSV format across all configured AWS profiles for their configured region
  • aws_eks_cloudwatch_logs.sh - enables and fetches AWS EKS Master logs via CloudWatch
  • aws_eks_ssh_dump_logs.sh - fetch system logs from EKS Worker Nodes EC2 VMs (eg. for support debug requests by vendors)
  • aws_eks_cluster_versions.sh - iterates EKS clusters to list each AWS EKS cluster name and version in the current account. Combine with aws_foreach_profile.sh and aws_foreach_region.sh to audit your EKS cluster versions across accounts and regions
  • aws_eks_addon_versions.sh - lists the EKS addon versions available for the given cluster by checking its version before checking addons
  • aws_eks_available_ips.sh - lists the number of available IP addresses in the EKS subnets for the given cluster (5 required for an EKS upgrade)
  • aws_eks_ami_create.sh - creates a custom EKS AMI quickly off the base EKS template and then running a shell script in it before saving it to a new AMI. See also HariSekhon/Packer for more advanced build
  • aws_kms_key_rotation_enabled.sh - lists AWS KMS keys and whether they have key rotation enabled
  • aws_kube_creds.sh - auto-loads all AWS EKS clusters credentials in the current --profile and --region so your kubectl is ready to rock on AWS
  • aws_kubectl.sh - runs kubectl commands safely fixed to a given AWS EKS cluster using config isolation to avoid concurrency race conditions
  • aws_logs_*.sh - some useful log queries in last N hours (24 hours by default):
    • aws_logs_batch_jobs.sh - lists AWS Batch job submission requests and their callers
    • aws_logs_ec2_spot.sh - lists AWS EC2 Spot fleet creation requests, their caller and first tag value for origin hint
    • aws_logs_ecs_tasks.sh - lists AWS ECS task run requests, their callers and job definitions
  • aws_meta.sh - AWS EC2 Metadata API query shortcut. See also the official ec2-metadata shell script with more features
  • aws_nat_gateways_public_ips.sh - lists the public IPs of all NAT gateways. Useful to give to clients to permit through firewalls for webhooks or similar calls
  • aws_rds_list.sh - list RDS instances with select fields - Name, Status, Engine, AZ, Instance Type, Storage
  • aws_rds_open_port_to_my_ip.sh - adds a security group to an RDS DB instance to open its native database SQL port to your public IP address
  • aws_rds_get_version.sh - quickly retrieve the version of an RDS database to know which JDBC jar version to download using install/download_*_jdbc.sh when setting up connections
  • aws_route53_check_ns_records.sh - checks AWS Route 53 public hosted zones NS servers are delegated in the public DNS hierarchy and that there are no rogue NS servers delegated not matching the Route 53 zone configuration
  • aws_sso_accounts.sh - lists all AWS SSO accounts the current SSO user has access to
  • aws_sso_configs.sh - generates AWS SSO configs for all AWS SSO accounts the currently logged in SSO user has access to
  • aws_sso_configs_save.sh - saves AWS SSO configs generated by aws_sso_configs.sh to ~/.aws/config if they're not already found
  • aws_sso_account_id_names.sh - parses AWS config for AWS SSO and outputs Account IDs and Profile names
  • aws_sso_config_duplicate_sections.sh - lists duplicate AWS SSO config sections that are using the same sso_account_id. Useful to deduplicate configs containing a mix of hand crafted and automatically generated aws_sso_configs.sh
  • aws_sso_config_duplicate_profile_names.sh - lists duplicate AWS SSO config profile names that are using the same sso_account_id
  • aws_accounts_missing_from_config.sh - for a list of AWS Account IDs in stdin or files, finds those missing from AWS config
  • aws_sso_accounts_missing_from_list.sh - for a list of AWS Account IDs in stdin or files, finds AWS SSO accounts in AWS config missing from the provided list
  • aws_sso_env_creds.sh - retrieves AWS SSO session credentials in the format of environment export commands for copying to other systems like Terraform Cloud
  • aws_sso_role_arn.sh - determines the currently authenticated AWS SSO user's base role ARN in IAM policy usable format
  • aws_sso_role_arns.sh - prints all AWS SSO role ARNs in IAM policy usable format
  • aws_profile_config_add_if_missing.sh - reads AWS profile config blocks from stdin and appends them to the ~/.aws/config file if the profile section is not found
  • aws_profile_generate_direnvs.sh - generates subdirectories containing the config.ini and .envrc for every AWS profile found in the given file or $AWS_CONFIG_FILE or ~/.aws/config. Useful to take a large generated AWS config.ini from aws_sso_configs.sh and then split it into subdirectories for direnvs
  • aws_s3_bucket.sh - creates an S3 bucket, blocks public access, enables versioning, encryption, and optionally locks out any given user/group/role ARNs via a bucket policy for safety (eg. to stop Power Users accessing a sensitive bucket like Terraform state)
  • aws_s3_buckets_block_public_access.sh - blocks public access to one or more given S3 buckets or files containing bucket names, one per line
  • aws_s3_account_block_public_access.sh - blocks S3 public access at the AWS account level
  • aws_s3_check_buckets_public_blocked.sh - iterates each S3 bucket and checks it has public access fully blocked via policy. Parallelized for speedup
  • aws_s3_check_account_public_blocked.sh - checks S3 public access is blocked at the AWS account level
  • aws_s3_sync.sh - syncs multiple AWS S3 URLs from file lists. Validates S3 URLs, source and destination list lengths matches, and optionally that path suffixes match, to prevent off-by-one human errors spraying data all over the wrong destination paths
  • aws_s3_access_logging.sh - lists AWS S3 buckets and their access logging status
  • aws_s3_delete_bucket_with_versions.sh - deletes a bucket including all versions. Use with caution!
  • aws_spot_when_terminated.sh - executes commands when the AWS EC2 instance running this script is notified of Spot Termination, acts as a latch mechanism that can be set any time after boot
  • aws_sqs_check.sh - sends a test message to an AWS SQS queue, retrieves it to check and then deletes it via the receipt handle id
  • aws_sqs_delete_message.sh - deletes 1-10 messages from a given AWS SQS queue (to help clear out test messages)
  • aws_ssm_put_param.sh - reads a value from a command line argument or non-echo prompt and saves it to AWS Systems Manager Parameter Store. Useful for uploading a password without exposing it on your screen
  • aws_secret*.sh - AWS Secrets Manager scripts:
    • aws_secret_list.sh - returns the list of secrets, one per line
    • aws_secret_add.sh - reads a value from a command line argument or non-echo prompt and saves it to Secrets Manager. Useful for uploading a password without exposing it on your screen
    • aws_secret_add_binary.sh - base64 encodes a given file's contents and saves it to Secrets Manager as a binary secret. Useful for uploading things like QR code screenshots for sharing MFA to recovery admin accounts
    • aws_secret_update.sh - reads a value from a command line argument or non-echo prompt and updates a given Secrets Manager secret. Useful for updating a password without exposing it on your screen
    • aws_secret_update_binary.sh - base64 encodes a given file's contents and updates a given Secrets Manager secret. Useful for updating a QR code screenshot for a root account
    • aws_secret_get.sh - gets a secret value for a given secret from Secrets Manager, retrieving either a secure string or secure binary depending on which is available
  • eksctl_cluster.sh - downloads eksctl and creates an AWS EKS Kubernetes cluster

See also Knowledge Base notes for AWS.

gcp/ directory:

• Google Cloud scripts - gcp_*.sh / gce_*.sh / gke_*.sh / gcr_*.sh / bigquery_*.sh:
  • .envrc-gcp - copy to .envrc for direnv to auto-load GCP configuration settings such as Project, Region, Zone, GKE cluster kubectl context or any other GCloud SDK settings to shorten gcloud commands. Applies to the local shell environment only to avoid race conditions caused by naively changing the global gcloud config at ~/.config/gcloud/active_config
    • calls .envrc-kubernetes to set the kubectl context isolated to current shell to prevent race conditions between shells and scripts caused by otherwise naively changing the global ~/.kube/config context
  • gcp_terraform_create_credential.sh - creates a service account for Terraform with full permissions, creates and downloads a credential key json and even prints the export GOOGLE_CREDENTIALS command to configure your environment to start using Terraform immediately. Run once for each project and combine with direnv for fast easy management of multiple GCP projects
  • gcp_ansible_create_credential.sh - creates an Ansible service account with permissions on the current project, creates and downloads a credential key json and prints the environment variable to immediately use it
  • gcp_cli_create_credential.sh - creates a GCloud SDK CLI service account with full owner permissions to all projects, creates and downloads a credential key json and even prints the export GOOGLE_CREDENTIALS command to configure your environment to start using it. Avoids having to reauth to gcloud auth login every day.
  • gcp_spinnaker_create_credential.sh - creates a Spinnaker service account with permissions on the current project, creates and downloads a credential key json and even prints the Halyard CLI configuration commands to use it
  • gcp_info.sh - huge Google Cloud inventory of deployed resources within the current project - Cloud SDK info plus all of the following (detects which services are enabled to query):
    • gcp_info_compute.sh - GCE Virtual Machine instances, App Engine instances, Cloud Functions, GKE clusters, all Kubernetes objects across all GKE clusters (see kubernetes_info.sh below for more details)
    • gcp_info_storage.sh - Cloud SQL info below, plus: Cloud Storage Buckets, Cloud Filestore, Cloud Memorystore Redis, BigTable clusters and instances, Datastore indexes
    • gcp_info_cloud_sql.sh - Cloud SQL instances, whether their backups are enabled, and all databases on each instance
      • gcp_info_cloud_sql_databases.sh - lists databases inside each Cloud SQL instance. Included in gcp_info_cloud_sql.sh
      • gcp_info_cloud_sql_backups.sh - lists backups for each Cloud SQL instance with their dates and status. Not included in gcp_info_cloud_sql.sh for brevity. See also gcp_sql_export.sh further down for more durable backups to GCS
      • gcp_info_cloud_sql_users.sh - lists users for each running Cloud SQL instance. Not included in gcp_info_cloud_sql.sh for brevity but useful to audit users
    • gcp_info_networking.sh - VPC Networks, Addresses, Proxies, Subnets, Routers, Routes, VPN Gateways, VPN Tunnels, Reservations, Firewall rules, Forwarding rules, Cloud DNS managed zones and verified domains
    • gcp_info_bigdata.sh - Dataproc clusters and jobs in all regions, Dataflow jobs in all regions, PubSub messaging topics, Cloud IOT registries in all regions
    • gcp_info_tools.sh - Cloud Source Repositories, Cloud Builds, Container Registry images across all major repos (gcr.io, us.gcr.io, eu.gcr.io, asia.gcr.io), Deployment Manager deployments
    • gcp_info_auth_config.sh - Auth Configurations, Organizations & Current Config
    • gcp_info_projects.sh - Projects names and IDs
    • gcp_info_services.sh - Services & APIs enabled
      • gcp_service_apis.sh - lists all available GCP Services, APIs and their states (enabled/disabled), and provides is_service_enabled() function used throughout the adjacent scripts to avoid errors and only show relevant enabled services
    • gcp_info_accounts_secrets.sh - IAM Service Accounts, Secret Manager secrets
  • gcp_info_all_projects.sh - same as above but for all detected projects
  • gcp_foreach_project.sh - executes a templated command across all GCP projects, replacing {project_id} and {project_name} in each iteration (used by gcp_info_all_projects.sh to call gcp_info.sh)
  • gcp_find_orphaned_disks.sh - lists orphaned disks across one or more GCP projects (not attached to any compute instance)
  • gcp_secret*.sh - Google Secret Manager scripts:
    • gcp_secret_add.sh - reads a value from a command line argument or non-echo prompt and saves it to GCP Secrets Manager. Useful for uploading a password without exposing it on your screen
    • gcp_secret_add_binary.sh - uploads a binary file to GCP Secrets Manager by base64 encoding it first. Useful for uploading QR code screenshots. Useful for uploading things like QR code screenshots for sharing MFA to recovery admin accounts
    • gcp_secret_update.sh - reads a value from a command line argument or non-echo prompt and updates a given GCP Secrets Manager secret. Useful for uploading a password without exposing it on your screen
    • gcp_secret_get.sh - finds the latest version of a given GCP Secret Manager secret and returns its value. Used by adjacent scripts
    • gcp_secret_label_k8s.sh - labels a given existing GCP secret with the current kubectl cluster name and namespace for later use by gcp_secrets_to_kubernetes.sh
    • gcp_secrets_to_kubernetes.sh - loads GCP secrets to Kubernetes secrets in a 1-to-1 mapping. Can specify a list of secrets or auto-loads all GCP secrets with labels kubernetes-cluster and kubernetes-namespace matching the current kubectl context (kcd to the right namespace first, see .bash.d/kubernetes). See also kubernetes_get_secret_values.sh to debug the actual values that got loaded. See also Sealed Secrets / External Secrets in my Kubernetes repo
    • gcp_secrets_to_kubernetes_multipart.sh - creates a Kubernetes secret from multiple GCP secrets (used to put private.pem and public.pem into the same secret to appear as files on volume mounts for apps in pods to use). See also Sealed Secrets / External Secrets in my Kubernetes repo
    • gcp_secrets_labels.sh - lists GCP Secrets and their labels, one per line suitable for quick views or shell pipelines
    • gcp_secrets_update_lable.sh - updates all GCP secrets in current project matching label key=value with a new label value
    • gcp_service_account_credential_to_secret.sh - creates GCP service account and exports a credential key to GCP Secret Manager (useful to stage or combine with gcp_secrets_to_kubernetes.sh)
  • gke_*.sh - Google Kubernetes Engine scripts
    • gke_kube_creds.sh - auto-loads all GKE clusters credentials in the current / given / all projects so your kubectl is ready to rock on GCP
    • gke_kubectl.sh - runs kubectl commands safely fixed to a given GKE cluster using config isolation to avoid concurrency race conditions
    • gke_firewall_rule_cert_manager.sh - creates a GCP firewall rule for a given GKE cluster's masters to access Cert Manager admission webhook (auto-determines the master cidr, network and target tags)
    • gke_firewall_rule_kubeseal.sh - creates a GCP firewall rule for a given GKE cluster's masters to access Sealed Secrets controller for kubeseal to work (auto-determines the master cidr, network and target tags)
    • gke_nodepool_nodes.sh - lists all nodes in a given nodepool on the current GKE cluster via kubectl labels (fast)
    • gke_nodepool_nodes2.sh - same as above via GCloud SDK (slow, iterates instance groups)
    • gke_nodepool_taint.sh - taints/untaints all nodes in a given GKE nodepool on the current cluster (see kubectl_node_taints.sh for a quick way to see taints)
    • gke_nodepool_drain.sh - drains all nodes in a given nodepool (to decommission or rebuild the node pool, for example with different taints)
    • gke_persistent_volumes_disk_mappings.sh - lists GKE kubernetes persistent volumes to GCP persistent disk names, along with PVC and namespace, useful when investigating, resizing PVs etc.
  • gcr_*.sh - Google Container Registry scripts:
    • gcr_list_tags.sh - lists all the tags for a given GCR docker image
    • gcr_newest_image_tags.sh - lists the tags for the given GCR docker image with the newest creation date (can use this to determine which image version to tag as latest)
    • gcr_alternate_tags.sh - lists all the tags for a given GCR docker image:tag (use arg <image>:latest to see what version / build hashref / date tag has been tagged as latest)
    • gcr_tag_latest.sh - tags a given GCR docker image:tag as latest without pulling or pushing the docker image
    • gcr_tag_branch.sh - tags a given GCR docker image:tag with the current Git branch without pulling or pushing the docker image
    • gcr_tag_datetime.sh - tags a given GCR docker image with its creation date and UTC timestamp (when it was uploaded or created by Google Cloud Build) without pulling or pushing the docker image
    • gcr_tag_newest_image_as_latest.sh - finds and tags the newest build of a given GCR docker image as latest without pulling or pushing the docker image
    • gcr_tags_timestamps.sh - lists all the tags and their timestamps for a given GCR docker image
    • gcr_tags_old.sh - lists tags older than N days for a given GCR docker image
    • gcr_delete_old_tags.sh - deletes tags older than N days for a given GCR docker image. Lists the image:tags to be deleted and prompts for confirmation safety
    • see also cloudbuild.yaml in the Templates repo
  • CI/CD on GCP - trigger Google Cloud Build and GKE Kubernetes deployments from orthogonal CI/CD systems like Jenkins / TeamCity:
    • gcp_ci_build.sh - script template for CI/CD to trigger Google Cloud Build to build docker container image with extra datetime and latest tagging
    • gcp_ci_deploy_k8s.sh - script template for CI/CD to deploy GCR docker image to GKE Kubernetes using Kustomize
  • gce_*.sh - Google Compute Engine scripts:
    • gce_foreach_vm.sh - run a command for each GCP VM instance matching the given name/ip regex in the current GCP project
    • gce_host_ips.sh - prints the IPs and hostnames of all or a regex match of GCE VMs for use in /etc/hosts
    • gce_ssh.sh - Runs gcloud compute ssh to a VM while auto-determining its zone first to override any inherited zone config and make it easier to script iterating through VMs
    • gcs_ssh_keyscan.sh - SSH keyscans all the GCE VMs returned from the above gce_host_ips.sh script and adds them to ~/.ssh/known_hosts
    • gce_meta.sh - simple script to query the GCE metadata API from within Virtual Machines
    • gce_when_preempted.sh - GCE VM preemption latch script - can be executed any time to set one or more commands to execute upon preemption
    • gce_is_preempted.sh - GCE VM return true/false if preempted, callable from other scripts
    • gce_instance_service_accounts.sh - lists GCE VM instance names and their service accounts
  • gcp_firewall_disable_default_rules.sh - disables those lax GCP default network "allow all" firewall rules
  • gcp_firewall_risky_rules.sh - lists risky GCP firewall rules that are enabled and allow traffic from 0.0.0.0/0
  • gcp_sql_*.sh - Cloud SQL scripts:
    • gcp_sql_backup.sh - creates Cloud SQL backups
    • gcp_sql_export.sh - creates Cloud SQL exports to GCS
    • gcp_sql_enable_automated_backups.sh - enable automated daily Cloud SQL backups
    • gcp_sql_enable_point_in_time_recovery.sh - enable point-in-time recovery with write-ahead logs
    • gcp_sql_proxy.sh - boots a Cloud SQL Proxy to all Cloud SQL instances for fast convenient direct psql / mysql access via local sockets. Installs Cloud SQL Proxy if necessary
    • gcp_sql_running_primaries.sh - lists primary running Cloud SQL instances
    • gcp_sql_service_accounts.sh - lists Cloud SQL instance service accounts. Useful for copying to IAM to grant permissions (eg. Storage Object Creator for SQL export backups to GCS)
    • gcp_sql_create_readonly_service_account.sh - creates a service account with read-only permissions to Cloud SQL eg. to run export backups to GCS
    • gcp_sql_grant_instances_gcs_object_creator.sh - grants minimal GCS objectCreator permission on a bucket to primary Cloud SQL instances for exports
  • gcp_cloud_schedule_sql_exports.sh - creates Google Cloud Scheduler jobs to trigger a Cloud Function via PubSub to run Cloud SQL exports to GCS for all Cloud SQL instances in the current GCP project
    • the Python GCF function is in the DevOps Python tools repo
  • bigquery_*.sh - BigQuery scripts:
    • bigquery_list_datasets.sh - lists BigQuery datasets in the current GCP project
    • bigquery_list_tables.sh - lists BigQuery tables in a given dataset
    • bigquery_list_tables_all_datasets.sh - lists tables for all datasets in the current GCP project
    • bigquery_foreach_dataset.sh - executes a templated command for each dataset
    • bigquery_foreach_table.sh - executes a templated command for each table in a given dataset
    • bigquery_foreach_table_all_datasets.sh - executes a templated command for each table in each dataset in the current GCP project
    • bigquery_table_row_count.sh - gets the row count for a given table
    • bigquery_tables_row_counts.sh - gets the row counts for all tables in a given dataset
    • bigquery_tables_row_counts_all_datasets.sh - gets the row counts for all tables in all datasets in the current GCP project
    • bigquery_generate_query_biggest_tables_across_datasets_by_row_count.sh - generates a BigQuery SQL query to find the top 10 biggest tables by row count
    • bigquery_generate_query_biggest_tables_across_datasets_by_size.sh - generates a BigQuery SQL query to find the top 10 biggest tables by size
    • see also the SQL Scripts repo for many more straight BigQuery SQL scripts
  • GCP IAM scripts:
    • gcp_service_account*.sh:
      • gcp_service_account_credential_to_secret.sh - creates GCP service account and exports a credential key to GCP Secret Manager (useful to stage or combine with gcp_secrets_to_kubernetes.sh)
      • gcp_service_accounts_credential_keys.sh - lists all service account credential keys and expiry dates, can grep 9999-12-31T23:59:59Z to find non-expiring keys
      • gcp_service_accounts_credential_keys_age.sh - lists all service account credential keys age in days
      • gcp_service_accounts_credential_keys_expired.sh - lists expired service account credential keys that should be removed and recreated if needed
      • gcp_service_account_members.sh - lists all members and roles authorized to use any service accounts. Useful for finding GKE Workload Identity mappings
    • gcp_iam_*.sh:
      • gcp_iam_roles_in_use.sh - lists GCP IAM roles in use in the current or all projects
      • gcp_iam_identities_in_use.sh - lists GCP IAM identities (users/groups/serviceAccounts) in use in the current or all projects
      • gcp_iam_roles_granted_to_identity.sh - lists GCP IAM roles granted to identities matching the regex (users/groups/serviceAccounts) in the current or all projects
      • gcp_iam_roles_granted_too_widely.sh - lists GCP IAM roles which have been granted to allAuthenticatedUsers or even worse allUsers (unauthenticated) in one or all projects
      • gcp_iam_roles_with_direct_user_grants.sh - lists GCP IAM roles which have been granted directly to users in violation of best-practice group-based management
      • gcp_iam_serviceaccount_members.sh - lists members with permissions to use each GCP service account
      • gcp_iam_serviceaccounts_without_permissions.sh - finds service accounts without IAM permissionns, useful to detect obsolete service accounts after a 90 day unused permissions clean out
      • gcp_iam_workload_identities.sh - lists GKE Workload Identity integrations, uses gcp_iam_serviceaccount_members.sh
      • gcp_iam_users_granted_directly.sh - lists GCP IAM users which have been granted roles directly in violation of best-practice group-based management
  • gcs_bucket_project.sh - finds the GCP project that a given bucket belongs to using the GCP Storage API
  • gcs_curl_file.sh - retrieves a GCS file's contents from a given bucket and path using the GCP Storage API. Useful for starting shell pipelines or being called from other scripts
  • firebase_foreach_project.sh - executes a templated command across all Firebase projects, replacing {project_id}, {project_number} and {project_name} in each iteration

See also Knowledge Base notes for GCP.

kubernetes/ directory:

• .envrc-kubernetes - copy to .envrc for direnv to auto-load the right Kubernetes kubectl context isolated to current shell to prevent race conditions between shells and scripts caused by otherwise naively changing the global ~/.kube/config context
• aws/eksctl_cluster.sh - quickly spins up an AWS EKS cluster using eksctl with some sensible defaults
• kubernetes_info.sh - huge Kubernetes inventory listing of deployed resources across all namespaces in the current cluster / kube context:
  • cluster-info
  • master component statuses
  • nodes
  • namespaces
  • deployments, replicasets, replication controllers, statefulsets, daemonsets, horizontal pod autoscalers
  • storage classes, persistent volumes, persistent volume claims
  • service accounts, resource quotas, network policies, pod security policies
  • container images running
  • container images running counts descending
  • pods (might be too much detail if you have high replica counts, so done last, comment if you're sure nobody has deployed pods outside deployments)
• kubectl.sh - runs kubectl commands safely fixed to a given context using config isolation to avoid concurrency race conditions
• kubectl_diff_apply.sh - generates a kubectl diff and prompts to apply
• kustomize_diff_apply.sh - runs Kustomize build, precreates any namespaces, shows a kubectl diff of the proposed changes, and prompts to apply
• kustomize_diff_branch.sh - runs Kustomize build against the current and target base branch for current or all given directories, then shows the diff for each directory. Useful to detect differences when refactoring, such as switching to tagged bases
• kubectl_create_namespaces.sh - creates any namespaces in yaml files or stdin, a prerequisite for a diff on a blank install, used by adjacent scripts for safety
• kubernetes_check_objects_namespaced.sh - checks Kubernetes yaml(s) for objects which aren't explicitly namespaced, which can easily result in deployments to the wrong namespace. Reads the API resources from your current Kubernetes cluster and if successful excludes cluster-wide objects
• kustomize_check_objects_namespaced.sh - checks Kustomize build yaml output for objects which aren't explicitly namespaced (uses above script)
• kubectl_deployment_pods.sh - gets the pod names with their unpredictable suffixes for a given deployment by querying the deployment's selector labels and then querying pods that match those labels
• kubectl_get_all.sh - finds all namespaced Kubernetes objects and requests them for the current or given namespace. Useful because kubectl get all misses a lof of object types
• kubectl_get_annotation.sh - find a type of object with a given annotation
• kubectl_restart.sh - restarts all or filtered deployments/statefulsets in the current or given namespace. Useful when debugging or clearing application problems
• kubectl_logs.sh - tails all containers in all pods or filtered pods in the current or given namespace. Useful when debugging a distributed set of pods in live testing
• kubectl_kv_to_secret.sh - creates a Kuberbetes secret from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
• kubectl_secret_values.sh - prints the keys and base64 decoded values within a given Kubernetes secret for quick debugging of Kubernetes secrets. See also: gcp_secrets_to_kubernetes.sh
• kubectl_secrets_download.sh - downloads all secrets in current or given namespace to local files of the same name, useful as a backup before migrating to Sealed Secrets
• kubernetes_secrets_compare_gcp_secret_manager.sh - compares each Kubernetes secret to the corresponding secret in GCP Secret Manager. Useful to safety check GCP Secret Manager values align before enabling External Secrets to replace them
• kubernetes_secret_to_external_secret.sh - generates an External Secret from an existing Kubernetes secret
• kubernetes_secrets_to_external_secrets.sh - generates External Secrets from all existing Kubernetes secrets found in the current or given namespace
• kubernetes_secret_to_sealed_secret.sh - generates a Bitnami Sealed Secret from an existing Kubernetes secret
• kubernetes_secrets_to_sealed_secrets.sh - generates Bitnami Sealed Secrets from all existing Kubernetes secrets found in the current or given namespace
• kubectl_secrets_annotate_to_be_sealed.sh - annotates secrets in current or given namespace to allow being overwritten by Sealed Secrets (useful to sync ArgoCD health)
• kubectl_secrets_not_sealed.sh - finds secrets with no SealedSecret ownerReferences
• kubectl_secrets_to_be_sealed.sh - finds secrets pending overwrite by Sealed Secrets with the managed annotation
• kubernetes_yaml_strip_live_fields.sh - strips live fields from Kubernetes yaml object dumps. Useful so you can do kubectl diff or kubectl apply without hitting annoying errors about immutable fields left in exports from kubectl get ... -o yaml
• kubernetes_foreach_context.sh - executes a command across all kubectl contexts, replacing {context} in each iteration (skips lab contexts docker / minikube / minishift to avoid hangs since they're often offline)
• kubernetes_foreach_namespace.sh - executes a command across all kubernetes namespaces in the current cluster context, replacing {namespace} in each iteration
  • Can be chained with kubernetes_foreach_context.sh and useful when combined with gcp_secrets_to_kubernetes.sh to load all secrets from GCP to Kubernetes for the current cluster, or combined with gke_kube_creds.sh and kubernetes_foreach_context.sh for all clusters!
• kubernetes_api.sh - finds Kubernetes API and runs your curl arguments against it, auto-getting authorization token and auto-populating OAuth authentication header
• kubernetes_autoscaler_release.sh - finds the latest Kubernetes Autoscaler release that matches your local Kubernetes cluster version using kubectl and the GitHub API. Useful for quickly finding the image override version for eks-cluster-autoscaler-kustomization.yaml in the Kubernetes configs repo
• kubernetes_etcd_backup.sh - creates a timestamped backup of the Kubernetes Etcd database for a kubeadm cluster
• kubernetes_delete_stuck_namespace.sh - to forcibly delete those pesky kubernetes namespaces of 3rd party apps like Knative that get stuck and hang indefinitely on the finalizers during deletion
• kubeadm_join_cmd.sh - outputs kubeadm join command (generates new token) to join an existing Kubernetes cluster (used in vagrant kubernetes provisioning scripts)
• kubeadm_join_cmd2.sh - outputs kubeadm join command manually (calculates cert hash + generates new token) to join an existing Kubernetes cluster
• kubernetes_nodes_ssh_dump_logs.sh - fetch logs from Kubernetes nodes (eg. for support debug requests by vendors)
• kubectl_exec.sh - finds and execs to the first Kubernetes pod matching the given name regex, optionally specifying the container name regex to exec to, and shows the full generated kubectl exec command line for clarity
• kubectl_exec2.sh - finds and execs to the first Kubernetes pod matching given pod filters, optionally specifying the container to exec to, and shows the full generated kubectl exec command line for clarity
• kubectl_pods_per_node.sh - lists number of pods per node sorted descending
• kubectl_pods_important.sh - lists important pods and their nodes to check on scheduling
• kubectl_pods_colocated.sh - lists pods from deployments/statefulsets that are colocated on the same node
• kubectl_node_labels.sh - lists nodes and their labels, one per line, easier to read visually or pipe in scripting
• kubectl_pods_running_with_labels.sh - lists running pods with labels matching key=value pair arguments
• kubectl_node_taints.sh - lists nodes and their taints
• kubectl_jobs_stuck.sh - finds Kubernetes jobs stuck for hours or days with no completions
• kubectl_jobs_delete_stuck.sh - prompts for confirmation to delete stuck Kubernetes jobs found by script above
• kubectl_images.sh - lists Kubernetes container images running on the current cluster
• kubectl_image_counts.sh - lists Kubernetes container images running counts sorted descending
• kubectl_image_deployments.sh - lists which deployments, statefulsets or daemonsets container images belong to. Useful to find which deployment, statefulset or daemonset to upgrade to replace a container image eg. when replacing deprecated the k8s.gcr.io registry with registry.k8s.io
• kubectl_pod_count.sh - lists Kubernetes pods total running count
• kubectl_pod_labels.sh - lists Kubernetes pods and their labels, one label per line for easier shell script piping for further actions
• kubectl_pod_ips.sh - lists Kubernetes pods and their pod IP addresses
• kubectl_container_count.sh - lists Kubernetes containers total running count
• kubectl_container_counts.sh - lists Kubernetes containers running counts by name sorted descending
• kubectl_pods_dump_*.sh - dump stats / logs / jstacks from all pods matching a given regex and namespace to txt files for support debugging
  • kubectl_pods_dump_stats.sh - dump stats
  • kubectl_pods_dump_logs.sh - dump logs
  • kubectl_pods_dump_jstacks.sh - dump Java jstacks
  • kubectl_pods_dump_all.sh - calls the above kubectl_pods_dump_*.sh scripts for N iterations with a given interval
• kubectl_empty_namespaces.sh - finds namespaces without any of the usual objects using kubectl get all
• kubectl_delete_empty_namespaces.sh - removes empty namespaces, uses kubectl_empty_namespaces.sh
• kubectl_<image>.sh - quick launch one-off pods for interactive debuggging in Kubernetes
  • kubectl_alpine.sh
  • kubectl_busybox.sh
  • kubectl_curl.sh
  • kubectl_dnsutils.sh
  • kubectl_gcloud_sdk.sh
  • kubectl_run_sa.sh - launch a quick pod with the given service account to test private repo pull & other permissions
• kubectl_port_forward.sh - launches kubectl port-forward to a given pod's port with an optional label or name filter. If more than one pod is found, prompts with an interactive dialogue to choose one. Optionally automatically opens the forwarded localhost URL in the default browser
  • kubectl_port_forward_spark.sh - does the above for Spark UI
• helm_template.sh - templates a Helm chart for Kustomize deployments
• kustomize_parse_helm_charts.sh - parses the Helm charts from one or more kustomization.yaml files into TSV format for further shell pipe processing
• kustomize_install_helm_charts.sh - installs the Helm charts from one or more kustomization.yaml files the old fashioned Helm CLI way so that tools like Nova can be used to detect outdated charts (used in Kubernetes-configs repo's CI)
• kustomize_update_helm_chart_versions.sh - updates one or more kustomization.yaml files to the latest versions of any charts they contain
• kustomize_materialize.sh - recursively materializes all kustomization.yaml to kustomization.materialized.yaml in the same directories for scanning with tools like Pluto to detect deprecated API objects inherited from embedded Helm charts. Parallelized for performance
• ArgoCD:
  • argocd_auto_sync.sh - toggle Auto-sync on/off to allow repairs and maintenance operation for a given app and also disables / re-enables the App-of-Apps base apps to stop then re-enabling the app
  • argocd_apps_sync.sh - sync's all ArgoCD apps matching an optional ERE regex filter on their names using the ArgoCD CLI
  • argocd_apps_wait_sync.sh - sync's all ArgoCD apps matching an optional ERE regex filter on their names using the ArgoCD CLI's while also checking their health and operation
  • argocd_generate_resource_whitelist.sh - generates a yaml cluster and namespace resource whitelist for ArgoCD project config. If given an existing yaml, will merge in its original whitelists, dedupe, and write them back into the file using an in-place edit. Useful because ArgoCD 2.2+ doesn't show resources that aren't explicitly allowed, such as ReplicaSets and Pods
• Pluto:
  • pluto_detect_helm_materialize.sh - recursively materializes all helm Chart.yaml and runs Pluto on each directory to work around this issue
  • pluto_detect_kustomize_materialize.sh - recursively materializes all kustomization.yaml and runs Pluto on each directory to work around this issue
  • pluto_detect_kubectl_dump_objects.sh - dumps all live Kubernetes objects to /tmp and runs Pluto to detect deprecated API objects on the cluster from any source
• Rancher:
  • rancher_api.sh - queries the Rancher API with authentication
  • rancher_kube_creds.sh - downloads all Rancher clusters credentials into subdirectories matching cluster names, with .envrc in each, so a quick cd into one and your kubectl is ready to rock
• see also Google Kubernetes Engine scripts in the GCP - Google Cloud Platform section above
• see also the Kubernetes configs repo

See also Knowledge Base notes for Kubernetes.

docker/ directory:

• docker_*.sh / dockerhub_*.sh - Docker / DockerHub API scripts:
  • dockerhub_api.sh - queries DockerHub API v2 with or without authentication ($DOCKERHUB_USER & $DOCKERHUB_PASSWORD / $DOCKERHUB_TOKEN)
  • docker_api.sh - queries a Docker Registry with optional basic authentication if $DOCKER_USER & $DOCKER_PASSWORD are set
  • docker_build_hashref.sh - runs docker build and auto-generates docker image name and tag from relative Git path and commit short SHA hashref and a dirty sha suffix if git contents are modified. Useful to compare docker image sizes between your clean and modified versions of Dockerfile or contents
  • docker_package_check.sh - runs package installs on major versions of a docker image to check given packages are available before adding them and breaking builds across linux distro versions
  • docker_registry_list_images.sh - lists images in a given private Docker Registry
  • docker_registry_list_tags.sh - lists tags for a given image in a private Docker Registry
  • docker_registry_get_image_manifest.sh - gets a given image:tag manifest from a private Docker Registry
  • docker_registry_tag_image.sh - tags a given image with a new tag in a private Docker Registry via the API without pulling and pushing the image data (must faster and more efficient)
  • dockerhub_list_tags.sh - lists tags for a given DockerHub repo. See also dockerhub_show_tags.py in the DevOps Python tools repo.
  • dockerhub_list_tags_by_last_updated.sh - lists tags for a given DockerHub repo sorted by last updated timestamp descending
  • dockerhub_search.sh - searches with a configurable number of returned items (older docker cli was limited to 25 results)
  • clean_caches.sh - cleans out OS package and programming language caches, call near end of Dockerfile to reduce Docker image size
  • see also the Dockerfiles repo
• quay_api.sh - queries the Quay.io API with OAuth2 authentication token $QUAY_TOKEN

See also Knowledge Base notes for Docker.

data/ directory:

• avro_tools.sh - runs Avro Tools jar, downloading it if not already present (determines latest version when downloading)

• parquet_tools.sh - runs Parquet Tools jar, downloading it if not already present (determines latest version when downloading)

• csv_header_indices.sh - list CSV headers with their zero indexed numbers, useful reference when coding against column positions

• ini_config_add_if_missing.sh - reads INI config blocks from stdin and appends them to the specified file if the section is not found. Used by aws_profile_config_add_if_missing.sh

• ini_config_duplicate_sections.sh - lists duplicate INI config sections that are using the same value for a given key in the given .ini file

• ini_config_duplicate_section_names.sh - lists duplicate INI config section names that are using the same value for a given key in the given .ini file

• ini_grep_section.sh - prints the named section from a given .ini file to stdout

• queue_*.sh - simple fast atomic durable local files based queuing using safe independent filesystem semantics:

  • queue_add.sh - creates an atomic queue file at the given location with the given data
  • queue_process.sh - returns the next queued item after atomically moving it to processing state
  • queue_requeue.sh - requeues the given item for reprocessing at the back of the queue so calling scripts don't get blocked retrying faulty queue items
  • queue_recover.sh - scans for stale queue processing items more than N minutes old and requeues them for reprocessing (for cases where a queue reader script has died without completion)

• wordcount.sh - counts and ranks words by their frequency in file(s) or stdin

• Data format validation validate_*.py from DevOps Python Tools repo:

  • CSV
  • JSON
  • Avro
  • Parquet
  • INI / Properties files (Java)
  • LDAP LDIF
  • XML
  • YAML

• json2yaml.sh - converts JSON to YAML

• yaml2json.sh - converts YAML to JSON - needed for some APIs like GitLab CI linting (see Gitlab section above)

bigdata/ and kafka/ directories:

• kafka_*.sh - scripts to make Kafka CLI usage easier including auto-setting Kerberos to source TGT from environment and auto-populating broker and zookeeper addresses. These are auto-added to the $PATH when .bashrc is sourced. For something similar for Solr, see solr_cli.pl in the DevOps Perl Tools repo.
• zookeeper*.sh - Apache ZooKeeper scripts:
  • zookeeper_client.sh - shortens zookeeper-client command by auto-populating the zookeeper quorum from the environment variable $ZOOKEEPERS or else parsing the zookeeper quorum from /etc/**/*-site.xml to make it faster and easier to connect
  • zookeeper_shell.sh - shortens Kafka's zookeeper-shell command by auto-populating the zookeeper quorum from the environment variable $KAFKA_ZOOKEEPERS and optionally $KAFKA_ZOOKEEPER_ROOT to make it faster and easier to connect
• hive_*.sh / beeline*.sh - Apache Hive scripts:
  • beeline.sh - shortens beeline command to connect to HiveServer2 by auto-populating Kerberos and SSL settings, zookeepers for HiveServer2 HA discovery if the environment variable $HIVE_HA is set or using the $HIVESERVER_HOST environment variable so you can connect with no arguments (prompts for HiveServer2 address if you haven't set $HIVESERVER_HOST or $HIVE_HA)
    • beeline_zk.sh - same as above for HiveServer2 HA by auto-populating SSL and ZooKeeper service discovery settings (specify $HIVE_ZOOKEEPERS environment variable to override). Automatically called by beeline.sh if either $HIVE_ZOOKEEPERS or $HIVE_HA is set (the latter parses hive-site.xml for the ZooKeeper addresses)
  • hive_foreach_table.sh - executes a SQL query against every table, replacing {db} and {table} in each iteration eg. select count(*) from {table}
  • hive_list_databases.sh - list Hive databases, one per line, suitable for scripting pipelines
  • hive_list_tables.sh - list Hive tables, one per line, suitable for scripting pipelines
  • hive_tables_metadata.sh - lists a given DDL metadata field for each Hive table (to compare tables)
  • hive_tables_location.sh - lists the data location per Hive table (eg. compare external table locations)
  • hive_tables_row_counts.sh - lists the row count per Hive table
  • hive_tables_column_counts.sh - lists the column count per Hive table
• impala*.sh - Apache Impala scripts:
  • impala_shell.sh - shortens impala-shell command to connect to Impala by parsing the Hadoop topology map and selecting a random datanode to connect to its Impalad, acting as a cheap CLI load balancer. For a real load balancer see HAProxy config for Impala (and many other Big Data & NoSQL technologies). Optional environment variables $IMPALA_HOST (eg. point to an explicit node or an HAProxy load balancer) and IMPALA_SSL=1 (or use regular impala-shell --ssl argument pass through)
  • impala_foreach_table.sh - executes a SQL query against every table, replacing {db} and {table} in each iteration eg. select count(*) from {table}
  • impala_list_databases.sh - list Impala databases, one per line, suitable for scripting pipelines
  • impala_list_tables.sh - list Impala tables, one per line, suitable for scripting pipelines
  • impala_tables_metadata.sh - lists a given DDL metadata field for each Impala table (to compare tables)
  • impala_tables_location.sh - lists the data location per Impala table (eg. compare external table locations)
  • impala_tables_row_counts.sh - lists the row count per Impala table
  • impala_tables_column_counts.sh - lists the column count per Impala table
• hdfs_*.sh - Hadoop HDFS scripts:
  • hdfs_checksum*.sh - walks an HDFS directory tree and outputs HDFS native checksums (faster) or portable externally comparable CRC32, in serial or in parallel to save time
  • hdfs_find_replication_factor_1.sh / hdfs_set_replication_factor_3.sh - finds HDFS files with replication factor 1 / sets HDFS files with replication factor <=2 to replication factor 3 to repair replication safety and avoid no replica alarms during maintenance operations (see also Python API version in the DevOps Python Tools repo)
  • hdfs_file_size.sh / hdfs_file_size_including_replicas.sh - quickly differentiate HDFS files raw size vs total replicated size
  • hadoop_random_node.sh - picks a random Hadoop cluster worker node, like a cheap CLI load balancer, useful in scripts when you want to connect to any worker etc. See also the read HAProxy Load Balancer configurations which focuses on master nodes
• cloudera_*.sh - Cloudera scripts:
  • cloudera_manager_api.sh - script to simplify querying Cloudera Manager API using environment variables, prompts, authentication and sensible defaults. Built on top of curl_auth.sh
  • cloudera_manager_impala_queries*.sh - queries Cloudera Manager for recent Impala queries, failed queries, exceptions, DDL statements, metadata stale errors, metadata refresh calls etc. Built on top of cloudera_manager_api.sh
  • cloudera_manager_yarn_apps.sh - queries Cloudera Manager for recent Yarn apps. Built on top of cloudera_manager_api.sh
  • cloudera_navigator_api.sh - script to simplify querying Cloudera Navigator API using environment variables, prompts, authentication and sensible defaults. Built on top of curl_auth.sh
  • cloudera_navigator_audit_logs.sh - fetches Cloudera Navigator audit logs for given service eg. hive/impala/hdfs via the API, simplifying date handling, authentication and common settings. Built on top of cloudera_navigator_api.sh
  • cloudera_navigator_audit_logs_download.sh - downloads Cloudera Navigator audit logs for each service by year. Skips existing logs, deletes partially downloaded logs on failure, generally retry safe (while true, Control-C, not kill -9 obviously). Built on top of cloudera_navigator_audit_logs.sh

See also Knowledge Base notes for Hadoop.

git/, github/, gitlab/, bitbucket/ and azure_devops/ directories:

• git/*.sh - Git scripts:
  • precommit_run_changed_files.sh - runs pre-commit on all files changed on the current branch vs the default branch. Useful to reproduce pre-commit checks that are failing in pull requests to get your PRs to pass
  • git_diff_commit.sh - quickly commits added or updated files to Git, showing a diff and easy enter prompt for each file. Super convenient for fast commits on the command line, and in vim and IDEs via hotkeys
  • git_review_push.sh - shows diff of what would be pushed upstream and prompts to push. Convenient for fast reviewed pushes via vim or IDEs hotkeys
  • git_branch_delete_squash_merged.sh - carefully detects if a squash merged branch you want to delete has no changes with the default trunk branch before deleting it. See Squash Merges in knowledge-base about why this is necessary.
  • git_tag_release.sh - creates a Git tag, auto-incrementing a .N suffix on the year/month/day date format if no exact version given
  • git_foreach_branch.sh - executes a command on all branches (useful in heavily version branched repos like in my Dockerfiles repo)
  • git_foreach_repo.sh - executes a command against all adjacent repos from a given repolist (used heavily by many adjacent scripts)
  • git_foreach_modified.sh - executes a command against each file with git modified status
  • git_foreach_repo_replace_readme_actions.sh - updates the README.md badges for GitHub Actions to match the local repo name. Useful to bulk fix copied badges quickly and easily
  • git_foreach_repo_update_readme.sh - git-diff-commits the README.md for each Git repo checkout using adjacent git_foreach_repo.sh and git_diff_commit.sh scripts. Useful to quickly bulk update README.md in all your projects, such as when references need updating
  • git_push_stats.sh - shows the Git push stats to the remote origin for the current branch - number of commits and lines of diff, using the following git_origin_*.sh scripts:
  • git_origin_log_to_push.sh - shows the Git log in local branch that would be pushed to remote origin
  • git_origin_files_to_push.sh - shows the Git files in local branch that would be pushed to remote origin
  • git_origin_diff_to_push.sh - shows the Git diff of lines in local branch that would be pushed to remote origin
  • git_origin_commit_count_to_push.sh - shows the number of Git commits in local branch that would be pushed to remote origin
  • git_origin_line_count_to_push.sh - shows the Git number of lines changed in local branch that would be pushed to remote origin. These are lines actually added / changed / removed without surrounding context lines
  • git_merge_all.sh / git_merge_master.sh / git_merge_master_pull.sh - merges updates from master branch to all other branches to avoid drift on longer lived feature branches / version branches (eg. Dockerfiles repo)
  • git_remotes_add_origin_providers.sh - auto-creates remotes for the 4 major public repositories (GitHub/GitLab/Bitbucket/Azure DevOps), useful for git pull -all to fetch and merge updates from all providers in one command
  • git_remotes_set_multi_origin.sh - sets up multi-remote origin for unified push to automatically keep the 4 major public repositories in sync (especially useful for Bitbucket and Azure DevOps which don't have GitLab's auto-mirroring from GitHub feature)
  • git_remotes_set_https_to_ssh.sh - converts local repo's remote URLs from https to ssh (more convenient with SSH keys instead of https auth tokens, especially since Azure DevOps expires personal access tokens every year)
  • git_remotes_set_ssh_to_https.sh - converts local repo's remote URLs from ssh to https (to get through corporate firewalls or hotels if you travel a lot)
  • git_remotes_set_https_creds_helpers.sh - adds Git credential helpers configuration to the local git repo to use http API tokens dynamically from environment variables if they're set
  • git_repos_pull.sh - pull multiple repos based on a source file mapping list - useful for easily sync'ing lots of Git repos among computers
  • git_repos_update.sh - same as above but also runs the make update build to install the latest dependencies, leverages the above script
  • git_grep_env_vars.sh - find environment variables in the current git repo's code base in the format SOME_VAR (useful to find undocumented environment variables in internal or open source projects such as ArgoCD eg. argoproj/argocd-cd #8680)
  • git_log_empty_commits.sh - find empty commits in git history (eg. if a git filter-branch was run but --prune-empty was forgotten, leaking metadata like subjects containing file names or other sensitive info)
  • git_log_me.sh - shows only commits in the Git log done by you. Useful to remind yourself what parts the current Git repo you've been working on for periodic reviews, reports or even updating your CV!
  • git_log_me_added.sh - same as above but only file addition commits
  • git_graph_commit_history_gnuplot.sh - generates GNUplot graphs of Git commits per year and per month for the entire history of the local Git repo checkout
  • git_graph_commit_history_mermaidjs.sh - generates MermaidJS graphs of Git commits per year and per month for the entire history of the local Git repo checkout
  • git_graph_commit_times_gnuplot.sh - generates a GNUplot graph of Git commit times from the current Git repo checkout's git log
  • git_graph_commit_times_mermaidjs.sh - generates a MermaidJS graph of Git commit times from the current Git repo checkout's git log
  • git_graph_commit_times_gnuplot_all_repos.sh - generates GNUplot graph of the GitHub commit times from all local adjacent Git repo checkouts listed in setup/repos.txt using Git log in each checkout
  • git_graph_commit_times_mermaidjs_all_repos.sh - generates MermaidJS graph of the GitHub commit times from all local adjacent Git repo checkouts listed in setup/repos.txt using Git log in each checkout
  • github_public_lines_of_code.sh - checks out all public original source GitHub repos for the current or given user and then counts all lines of code for them with breakdowns of languages, files, code, comments and blanks
  • git_revert_line.sh - reverts the first line that matches a given regex from the Git head commit's version of the same line number. Useful to revert some changes caused by over zealous sed'ing scripts, where you want to cherry-pick revert a single line change
  • git_files_no_uncommitted_changes.sh - returns zero if given file(s) don't have uncommitted changes to Git, either staged or unstaged. Useful to be able to iterate over git files with in-place edits only if safe to do so without other uncommitted changes that would be at risk of being lost
  • git_files_in_history.sh - finds all filename / file paths in the git log history, useful for prepping for git filter-branch
  • git_filter_branch_fix_author.sh - rewrites Git history to replace author/committer name & email references (useful to replace default account commits). Powerful, read --help and man git-filter-branch carefully. Should only be used by Git Experts
  • git_filter_repo_replace_text.sh - rewrites Git history to replace a given text to scrub a credential or other sensitive token from history. Refuses to operate on tokens less than 8 chars for safety
  • git_submodules_update.sh - updates all submodules in the local git repo to the latest commit of their detected default trunk branch
  • git_submodules_update_repos.sh - updates submodules for all repos given as args or saved in the setup/repos.txt file
  • git_askpass.sh - credential helper script to use environment variables for git authentication
• github/*.sh - GitHub API / CLI scripts:
  • github_api.sh - queries the GitHub API. Can infer GitHub user, repo and authentication token from local checkout or environment ($GITHUB_USER, $GITHUB_TOKEN)
  • github_install_binary.sh - installs a binary from GitHub releases into $HOME/bin or /usr/local/bin. Auto-determines the latest release if no version specified, detects and unpacks any tarball or zip files
  • github_foreach_repo.sh - executes a templated command for each non-fork GitHub repo, replacing the {owner}/{name} or {repo} placeholders in each iteration
  • github_graph_commit_times_gnuplot.sh - generates GNUplot graph of GitHub commit times from all public GitHub repos for a given user. Fetches the commit data via the GitHub API
  • github_graph_commit_times_mermaidjs.sh - generates MermaidJS graph of the GitHub commit times from all public GitHub repos for a given user. Fetches the commit data via the GitHub API
  • github_clone_or_pull_all_repos.sh - git clones or pulls all repos for a user or organization into directories of the same name under the current directory
  • github_download_release_file.sh - downloads a file from GitHub Releases, optionally determining the latest version, uses bin/download_url_file.sh
  • github_download_release_jar.sh - downloads a JAR file from GitHub Releases (used by install/download_*_jar.sh for things like JDBC drivers or Java decompilers), optionally determines latest version to download, and finally validates the downloaded file's format
  • github_invitations.sh - lists / accepts repo invitations. Useful to accept a large number of invites to repos generated by automation
  • github_mirror_repos_to_gitlab.sh - creates/syncs GitHub repos to GitLab for migrations or to cron fast free Disaster Recovery, including all branches and tags, plus the repo descriptions. Note this doesn't include PRs/wikis/releases
  • github_mirror_repos_to_bitbucket.sh - creates/syncs GitHub repos to BitBucket for migrations or to cron fast free Disaster Recovery, including all branches and tags, plus the repo descriptions. Note this doesn't include PRs/wikis/releases
  • github_mirror_repos_to_aws_codecommit.sh - creates/syncs GitHub repos to AWS CodeCommit for migrations or to cron fast almost free Disaster Recovery (close to $0 compared to $100-400+ per month for Rewind BackHub), including all branches and tags, plus the repo descriptions. Note this doesn't include PRs/wikis/releases
  • github_mirror_repos_to_gcp_source_repos.sh - creates/syncs GitHub repos to GCP Source Repos for migrations or to cron fast almost free Disaster Recovery (close to $0 compared to $100-400+ per month for Rewind BackHub), including all branches and tags. Note this doesn't include repo description/PRs/wikis/releases
  • github_pull_request_create.sh - creates a Pull Request idempotently by first checking for an existing PR between the branches, and also checking if there are the necessary commits between the branches, to avoid common errors from blindly raising PRs. Useful to automate code promotion across environment branches. Also works across repo forks and is used by github_repo_fork_update.sh. Even populates github pull request template and does Jira ticket number replacement from branch prefix
  • github_pull_request_preview.sh - opens a GitHub Pull Request preview page from the current local branch to the given or default branch
  • github_push_pr_preview.sh - pushes to GitHub origin, sets upstream branch, then open a Pull Request preview from current branch to the given or default trunk branch in your browser
  • github_push_pr.sh - pushes to GitHub origin, sets upstream branch, then idemopotently creates a Pull Request from current branch to the given or default trunk branch and opens the generated PR in your browser for review
  • github_merge_branch.sh - merges one branch into another branch via a Pull Request for full audit tracking all changes. Useful to automate feature PRs, code promotion across environment branches, or backport hotfixes from Production or Staging to trunk branches such as master, main, dev or develop
  • github_remote_set_upstream.sh - in a forked GitHub repo's checkout, determine the origin of the fork using GitHub CLI and configure a git remote to the upstream. Useful to be able to easily pull updates from the original source repo
  • github_pull_merge_trunk.sh - pulls the origin or fork upstream repo's trunk branch and merges it into the local branch, In a forked GitHub repo's checkout, determines the origin of the fork using GitHub CLI, configures a git remote to the upstream, pulls the default branch and if on a branch other than the default then merges the default branch to the local current branch. Simplifies and automates keeping your checkout or forked repo up to date with the original source repo to quickly resolve merge conflicts locally and submit updated Pull Requests
  • github_forked_add_remote.sh - quickly adds a forked repo as a remote from an interactive menu list of forked repos
  • github_forked_checkout_branch.sh - quickly check out a forked repo's branch from an interactive menu lists of forked repos and their branches
  • github_forks_containing_commit.sh - finds all forks of a repo that contain a given commit hash to find private information for removal requests
  • github_tag_hashref.sh - Returns the GitHub commit hashref for a given GitHub Actions owner/repo@tag or https://github.com/owner/repo@tag. Useful for pinning 3rd party GitHub Actions to hashref instead of tag to follow GitHub Actions Best Practices
  • github_actions_foreach_workflow.sh - executes a templated command for each workflow in a given GitHub repo, replacing {name}, {id} and {state} in each iteration
  • github_actions_aws_create_load_credential.sh - creates an AWS user with group/policy, generates and downloads access keys, and uploads them to the given repo
  • github_actions_in_use.sh - lists GitHub Actions directly referenced in the .github/workflows in the current local repo checkout
  • github_actions_in_use_repo.sh - lists GitHub Actions for a given repo via the API, including following imported reusable workflows
  • github_actions_in_use_across_repos.sh - lists GitHub Actions in use across all your repos
  • github_actions_repos_lockdown.sh - secures GitHub Actions settings across all user repos to only GitHub, verified partners and selected 3rd party actions
  • github_actions_repo_set_secret.sh - sets a secret in the given repo from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
  • github_actions_repo_env_set_secret.sh - sets a secret in the given repo and environment from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
  • github_actions_repo_secrets_overriding_org.sh - finds any secrets for a repo that are overriding organization level secrets. Useful to combine with github_foreach_repo.sh for auditing
  • github_actions_repo_restrict_actions.sh - restricts GitHub Actions in the given repo to only running actions from GitHub and verfied partner companies (.eg AWS, Docker)
  • github_actions_repo_actions_allow.sh - allows select 3rd party GitHub Actions in the given repo
  • github_actions_runner.sh - generates a GitHub Actions self-hosted runner token for a given Repo or Organization via the GitHub API and then runs a dockerized GitHub Actions runner with the appropriate configuration
  • github_actions_runner_local.sh - downloads, configures and runs a local GitHub Actions Runner for Linux or Mac
  • github_actions_runner_token.sh - generates a GitHub Actions runner token to register a new self-hosted runner
  • github_actions_runners.sh - lists GitHub Actions self-hosted runners for a given Repo or Organization
  • github_actions_delete_offline_runners.sh - deletes offline GitHub Actions self-hosted runners. Useful to clean up short-lived runners eg. Docker, Kubernetes
  • github_actions_workflows.sh - lists GitHub Actions workflows for a given repo (or auto-infers local repository)
  • github_actions_workflow_runs.sh - lists GitHub Actions workflow runs for a given workflow id or name
  • github_actions_workflows_status.sh - lists all GitHub Actions workflows and their statuses for a given repo
  • github_actions_workflows_state.sh - lists GitHub Actions workflows enabled/disabled states (GitHub now disables workflows after 6 months without a commit)
  • github_actions_workflows_disabled.sh - lists GitHub Actions workflows that are disabled. Combine with github_foreach_repo.sh to scan all repos to find disabled workflows
  • github_actions_workflow_enable.sh - enables a given GitHub Actions workflow
  • github_actions_workflows_enable_all.sh - enables all GitHub Actions workflows in a given repo. Useful to undo GitHub disabling all workflows in a repo after 6 months without a commit
  • github_actions_workflows_trigger_all.sh - triggers all workflows for the given repo
  • github_actions_workflows_cancel_all_runs.sh - cancels all workflow runs for the given repo
  • github_actions_workflows_cancel_waiting_runs.sh - cancels workflow runs that are in waiting state, eg. waiting for old deployment approvals
  • github_actions_log.sh - outputs the text log for a given GitHub Actions workflow run to the terminal. Fetches the last 10 runs and drops you into an interactive menu to hit enter on the one you want. Useful when the logs are too big for the UI and you have to open it in another tab which is very slow in browser
  • github_actions_latest_log.sh - same as above, but just fetches the latest workflow run log without any prompting
  • github_ssh_get_user_public_keys.sh - fetches a given GitHub user's public SSH keys via the API for piping to ~/.ssh/authorized_keys or adjacent tools
  • github_ssh_get_public_keys.sh - fetches the currently authenticated GitHub user's public SSH keys via the API, similar to above but authenticated to get identifying key comments
  • github_ssh_add_public_keys.sh - uploads SSH keys from local files or standard input to the currently authenticated GitHub account. Specify pubkey files (default: ~/.ssh/id_rsa.pub) or read from standard input for piping from adjacent tools
  • github_ssh_delete_public_keys.sh - deletes given SSH keys from the currently authenticated GitHub account by key id or title regex match
  • github_gpg_get_user_public_keys.sh - fetches a given GitHub user's public GPG keys via the API
  • github_generate_status_page.sh - generates a STATUS.md page by merging all the README.md headers for all of a user's non-forked GitHub repos or a given list of any repos etc.
  • github_purge_camo_cache.sh - send HTTP Purge requests to all camo urls (badge caches) for the current or given GitHub repo's landing/README.md page
  • github_ip_ranges.sh - returns GitHub's IP ranges, either all by default or for a select given service such as hooks or actions
  • github_sync_repo_descriptions.sh - syncs GitHub repo descriptions to GitLab & BitBucket repos
  • github_release.sh - creates a GitHub Release, auto-incrementing a .N suffix on the year/month/day date format if no exact version given
  • github_repo_check_pat_token.sh - checks the given PAT token can access the given GitHub repo. Useful to test a PAT token used for integrations like ArgoCD
  • github_repo_description.sh - fetches the given repo's description (used by github_sync_repo_descriptions.sh)
  • github_repo_find_files.sh - finds files matching a regex in the current or given GitHub repo via the GitHub API
  • github_repo_latest_release.sh - returns the latest release tag for a given GitHub repo via the GitHub API
  • github_repo_latest_release_filter.sh - returns the latest release tag matching a given regex filter for a given GitHub repo via the GitHub API. Useful for getting the latest version of things like Kustomize which has other releases for kyaml
  • github_repo_stars.sh - fetches the stars, forks and watcher counts for a given repo
  • github_repo_teams.sh - fetches the GitHub Enterprise teams and their role permisions for a given repo. Combine with github_foreach_repo.sh to audit your all your personal or GitHub organization's repos
  • github_repo_collaborators.sh - fetches a repo's granted users and outside invited collaborators as well as their role permisions for a given repo. Combine with github_foreach_repo.sh to audit your all your personal or GitHub organization's repos
  • github_repo_protect_branches.sh - enables branch protections on the given repo. Can specify one or more branches to protect, otherwise finds and applies to any of master, main, develop, dev, staging, production
  • github_repos_find_files.sh - finds files matching a regex across all repos in the current GitHub organization or user account
  • github_repo_fork_sync.sh - sync's current or given fork, then runs github_repo_fork_update.sh to cascade changes to major branches via Pull Requests for auditability
  • github_repo_fork_update.sh - updates a forked repo by creating pull requests for full audit tracking and auto-merges PRs for non-production branches
  • github_repos_public.sh - lists public repos for a user or organization. Useful to periodically scan and account for any public repos
  • github_repos_disable_wiki.sh - disables the Wiki on one or more given repos to prevent documentation fragmentation and make people use the centralized documentation tool eg. Confluence or Slite
  • github_repos_with_few_users.sh - finds repos with few or no users (default: 1), which in Enterprises is a sign that a user has created a repo without assigning team privileges
  • github_repos_with_few_teams.sh - finds repos with few or no teams (default: 0), which in Enterprises is a sign that a user has created a repo without assigning team privileges
  • github_repos_without_branch_protections.sh - finds repos without any branch protection rules (use github_repo_protect_branches.sh on such repos)
  • github_repos_not_in_terraform.sh - finds all non-fork repos for current or given user/organization which are not found in $PWD/*.tf Terraform code
  • github_teams_not_in_terraform.sh - finds all teams for given organization which are not found in $PWD/*.tf Terraform code
  • github_repos_sync_status.sh - determines whether each GitHub repo's mirrors on GitLab / BitBucket / Azure DevOps are up to date with the latest commits, by querying all 3 APIs and comparing master branch hashrefs
  • github_teams_not_idp_synced.sh - finds GitHub teams that aren't sync'd from an IdP like Azure AD. These should usually be migrated or removed
  • github_user_repos_stars.sh - fetches the total number of stars for all original source public repos for a given user
  • github_user_repos_forks.sh - fetches the total number of forks for all original source public repos for a given user
  • github_user_repos_count.sh - fetches the total number of original source public repos for a given username
  • github_user_followers.sh - fetches the number of followers for a given username
  • github_url_clipboard.sh - copies a GitHub URL file's contents to the clipboard, converting the URL to a raw GitHub content URL where necessary
• gitlab/*.sh - GitLab API scripts:
  • gitlab_api.sh - queries the GitLab API. Can infer GitLab user, repo and authentication token from local checkout or environment ($GITLAB_USER, $GITLAB_TOKEN)
  • gitlab_install_binary.sh - installs a binary from GitLab releases into $HOME/bin or /usr/local/bin. Auto-determines the latest release if no version specified, detects and unpacks any tarball or zip files
  • gitlab_push_mr_preview.sh - pushes to GitLab origin, sets upstream branch, then open a Merge Request preview from current to default branch
  • github_push_mr.sh - pushes to GitLab origin, sets upstream branch, then idemopotently creates a Merge Request from current branch to the given or default trunk branch and opens the generated MR in your browser for review
  • gitlab_foreach_repo.sh - executes a templated command for each GitLab project/repo, replacing the {user} and {project} in each iteration
  • gitlab_project_latest_release.sh - returns the latest release tag for a given GitLab project (repo) via the GitLab API
  • gitlab_project_set_description.sh - sets the description for one or more projects using the GitLab API
  • gitlab_project_set_env_vars.sh - adds / updates GitLab project-level environment variable(s) via the API from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
  • gitlab_group_set_env_vars.sh - adds / updates GitLab group-level environment variable(s) via the API from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
  • gitlab_project_create_import.sh - creates a GitLab repo as an import from a given URL, and mirrors if on GitLab Premium (can only manually configure for public repos on free tier, API doesn't support configuring even public repos on free)
  • gitlab_project_protect_branches.sh - enables branch protections on the given project. Can specify one or more branches to protect, otherwise finds and applies to any of master, main, develop, dev, staging, production
  • gitlab_project_mirrors.sh - lists each GitLab repo and whether it is a mirror or not
  • gitlab_pull_mirror.sh - trigger a GitLab pull mirroring for a given project's repo, or auto-infers project name from the local git repo
  • gitlab_ssh_get_user_public_keys.sh - fetches a given GitLab user's public SSH keys via the API, with identifying comments, for piping to ~/.ssh/authorized_keys or adjacent tools
  • gitlab_ssh_get_public_keys.sh - fetches the currently authenticated GitLab user's public SSH keys via the API
  • gitlab_ssh_add_public_keys.sh - uploads SSH keys from local files or standard input to the currently authenticated GitLab account. Specify pubkey files (default: ~/.ssh/id_rsa.pub) or read from standard input for piping from adjacent tools
  • gitlab_ssh_delete_public_keys.sh - deletes given SSH keys from the currently authenticated GitLab account by key id or title regex match
  • gitlab_validate_ci_yaml.sh - validates a .gitlab-ci.yml file via the GitLab API
• bitbucket/*.sh - BitBucket API scripts:
  • bitbucket_api.sh - queries the BitBucket API. Can infer BitBucket user, repo and authentication token from local checkout or environment ($BITBUCKET_USER, $BITBUCKET_TOKEN)
  • bitbucket_foreach_repo.sh - executes a templated command for each BitBucket repo, replacing the {user} and {repo} in each iteration
  • bitbucket_workspace_set_env_vars.sh - adds / updates Bitbucket workspace-level environment variable(s) via the API from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
  • bitbucket_repo_set_env_vars.sh - adds / updates Bitbucket repo-level environment variable(s) via the API from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
  • bitbucket_repo_set_description.sh - sets the description for one or more repos using the BitBucket API
  • bitbucket_enable_pipelines.sh - enables the CI/CD pipelines for all repos
  • bitbucket_disable_pipelines.sh - disables the CI/CD pipelines for all repos
  • bitbucket_repo_enable_pipeline.sh - enables the CI/CD pipeline for a given repo
  • bitbucket_repo_disable_pipeline.sh - disables the CI/CD pipeline for a given repo
  • bitbucket_ssh_get_public_keys.sh - fetches the currently authenticated BitBucket user's public SSH keys via the API for piping to ~/.ssh/authorized_keys or adjacent tools
  • bitbucket_ssh_add_public_keys.sh - uploads SSH keys from local files or standard input to the currently authenticated BitBucket account. Specify pubkey files (default: ~/.ssh/id_rsa.pub) or read from standard input for piping from adjacent tools
  • bitbucket_ssh_delete_public_keys.sh - uploads SSH keys from local files or standard input to the currently authenticated BitBucket account. Specify pubkey files (default: ~/.ssh/id_rsa.pub) or read from standard input for piping from adjacent tools

See also Knowledge Base notes for Git.

Maintain your Git README.md and similar Markdown documentation well.

• markdown/*:
  • markdown_generate_index.sh - generates a markdown index list from the headings in a given markdown file such as README.md
  • markdown_replace_index.sh - replaces a markdown index section in a given markdown file using markdown_generate_index.sh
  • markdown_replace_repos.sh - replaces the repos block of a given markdown file. Used to keep my GitHub repos Other Repos sections updated
  • mdl_list_indentations.sh- runs Markdownlint mdl command and prefixes the spaces count to each offending line of MD005 (inconsistent list indentations). Workaround for Markdownlint issue #520
  • markdown_list_indentations.sh - prefixes number of spaces before each list item for comparison to MarkdownLint MD005 inconsistent list indentation error
  • markdown_columns_to_table.sh - converts text columns separated by whitespace to a Markdown table with vertically aligned column pipe chars. Combine with scripts like domains_subdomains_environments.sh to generate the markdown documentation of your domains and subdomains per project and environment
  • markdown_octocat_github_links.sh - converts GitHub links like <https://github.com/HariSekhon/Knowledge-Base> to shorthand links with an OctoCat emoji and without the redundant https://github.com/ prefix such as HariSekhon/Knowledge-Base
  • markdown_replace_links_with_jsdelivr.sh - replaces local GitHub repo file links in the given markdown file(s) with JSDelivr CDN links
  • markdown_youtube_thumbnail_link.sh - creates a markdown thumbnail link for the given youtube video URL and copies it to the clipboard for quick pasting into your markdown

jenkins/, terraform/, teamcity/, buildkite/, circlci/, travis/, azure_devops/, ..., cicd/ directories:

• appveyor_api.sh - queries AppVeyor's API with authentication
• azure_devops/*.sh - Azure DevOps scripts:
  • azure_devops_api.sh - queries Azure DevOps's API with authentication
  • azure_devops_foreach_repo.sh - executes a templated command for each Azure DevOps repo, replacing {user}, {org}, {project} and {repo} in each iteration
  • azure_devops_to_github_migration.sh - migrates one or all Azure DevOps git repos to GitHub, including all branches and sets the default branch to match via the APIs to maintain the same checkout behaviour
  • azure_devops_disable_repos.sh - disables one or more given Azure DevOps repos (to prevent further pushes to them after migration to GitHub)
• circleci/*.sh - CircleCI scripts:
  • circleci_api.sh - queries CircleCI's API with authentication
  • circleci_project_set_env_vars.sh - adds / updates CircleCI project-level environment variable(s) via the API from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
  • circleci_context_set_env_vars.sh - adds / updates CircleCI context-level environment variable(s) via the API from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
  • circleci_project_delete_env_vars.sh - deletes CircleCI project-level environment variable(s) via the API
  • circleci_context_delete_env_vars.sh - deletes CircleCI context-level environment variable(s) via the API
  • circleci_local_execute.sh - installs CircleCI CLI and executes .circleci/config.yml locally
  • circleci_public_ips.sh - lists CircleCI public IP addresses via dnsjson.com
• codeship_api.sh - queries CodeShip's API with authentication
• drone_api.sh - queries Drone.io's API with authentication
• shippable_api.sh - queries Shippable's API with authentication
• wercker_app_api.sh - queries Wercker's Applications API with authentication
• gocd_api.sh - queries GoCD's API
• gocd.sh - one-touch GoCD CI:
  • launches in Docker
  • (re)creates config repo ($PWD/setup/gocd_config_repo.json) from which to source pipeline(s) (.gocd.yml)
  • detects and enables agent(s) to start building
  • call from any repo top level directory with a .gocd.yml config (all mine have it), mimicking structure of fully managed CI systems
• concourse.sh - one-touch Concourse CI:
  • launches in Docker
  • configures pipeline from $PWD/.concourse.yml
  • triggers build
  • tails results in terminal
  • prints recent build statuses at end
  • call from any repo top level directory with a .concourse.yml config (all mine have it), mimicking structure of fully managed CI systems
• fly.sh - shortens Concourse fly command to not have to specify target all the time
• jenkins/*.sh - Jenkins CI scripts:
  • jenkins.sh - one-touch Jenkins CI:
    • launches Docker container
    • installs plugins
    • validates Jenkinsfile
    • configures job from $PWD/setup/jenkins-job.xml
    • sets Pipeline to git remote origin's Jenkinsfile
    • triggers build
    • tails results in terminal
    • call from any repo top level directory with a Jenkinsfile pipeline and setup/jenkins-job.xml (all mine have it)
  • jenkins_api.sh - queries the Jenkins Rest API, handles authentication, pre-fetches CSFR protection token crumb, supports many environment variables such as $JENKINS_URL for ease of use
    • jenkins_jobs.sh - lists Jenkins jobs (pipelines)
    • jenkins_foreach_job.sh - runs a templated command for each Jenkins job
    • jenkins_jobs_download_configs.sh - downloads all Jenkins job configs to xml files of the same name
    • jenkins_job_config.sh - gets or sets a Jenkins job's config
    • jenkins_job_description.sh - gets or sets a Jenkins job's description
    • jenkins_job_enable.sh - enables a Jenkins job by name
    • jenkins_job_disable.sh - disables a Jenkins job by name
    • jenkins_job_trigger.sh - triggers a Jenkins job by name
    • jenkins_job_trigger_with_params.sh - triggers a Jenkins job with parameters which can be passed as --data KEY=VALUE
    • jenkins_jobs_enable.sh - enables all Jenkins jobs/pipelines with names matching a given regex
    • jenkins_jobs_disable.sh - disables all Jenkins jobs/pipelines with names matching a given regex
    • jenkins_builds.sh - lists Jenkins latest builds for every job
    • jenkins_cred_add_cert.sh - creates a Jenkins certificate credential from a PKCS#12 keystore
    • jenkins_cred_add_kubernetes_sa.sh - creates a Jenkins Kubernetes service account credential
    • jenkins_cred_add_secret_file.sh - creates a Jenkins secret file credential from a file
    • jenkins_cred_add_secret_text.sh - creates a Jenkins secret string credential from a string or a file
    • jenkins_cred_add_ssh_key.sh - creates a Jenkins SSH key credential from a string or an SSH private key file
    • jenkins_cred_add_user_pass.sh - creates a Jenkins username/password credential
    • jenkins_cred_delete.sh - deletes a given Jenkins credential by id
    • jenkins_cred_list.sh - lists Jenkins credentials IDs and Names
    • jenkins_cred_update_cert.sh - updates a Jenkins certificate credential from a PKCS#12 keystore
    • jenkins_cred_update_kubernetes_sa.sh - updates a Jenkins Kubernetes service account credential
    • jenkins_cred_update_secret_file.sh - updates a Jenkins secret file credential from a file
    • jenkins_cred_update_secret_text.sh - updates a Jenkins secret string credential from a string or a file
    • jenkins_cred_update_ssh_key.sh - updates a Jenkins SSH key credential from a string or an SSH private key file
    • jenkins_cred_update_user_pass.sh - updates a Jenkins username/password credential
    • jenkins_cred_set_cert.sh - creates or updates a Jenkins certificate credential from a PKCS#12 keystore
    • jenkins_cred_set_kubernetes_sa.sh - creates or updates a Jenkins Kubernetes service account credential
    • jenkins_cred_set_secret_file.sh - creates or updates a Jenkins secret file credential from a file
    • jenkins_cred_set_secret_text.sh - creates or updates a Jenkins secret string credential from a string or a file
    • jenkins_cred_set_ssh_key.sh - creates or updates a Jenkins SSH key credential from a string or an SSH private key file
    • jenkins_cred_set_user_pass.sh - creates or updates a Jenkins username/password credential
  • jenkins_cli.sh - shortens jenkins-cli.jar command by auto-inferring basic configuations, auto-downloading the CLI if absent, inferrings a bunch of Jenkins related variables like $JENKINS_URL, $JENKINS_CLI_ARGS and authentication using $JENKINS_USER/$JENKINS_PASSWORD, or finds admin password from inside local docker container. Used heavily by jenkins.sh one-shot setup and the following scripts:
    • jenkins_foreach_job_cli.sh - runs a templated command for each Jenkins job
    • jenkins_create_job_parallel_test_runs.sh - creates a freestyle parameterized test sleep job and launches N parallel runs of it to test scaling and parallelization of Jenkins on Kubernetes agents
    • jenkins_create_job_check_gcp_serviceaccount.sh - creates a freestyle test job which runs a GCP Metadata query to determine the GCP serviceaccount the agent pod is operating under to check GKE Workload Identity integration
    • jenkins_jobs_download_configs_cli.sh - downloads all Jenkins job configs to xml files of the same name
    • jenkins_cred_cli_add_cert.sh - creates a Jenkins certificate credential from a PKCS#12 keystore
    • jenkins_cred_cli_add_kubernetes_sa.sh - creates a Jenkins Kubernetes service account credential
    • jenkins_cred_cli_add_secret_file.sh - creates a Jenkins secret file credential from a file
    • jenkins_cred_cli_add_secret_text.sh - creates a Jenkins secret string credential from a string or a file
    • jenkins_cred_cli_add_ssh_key.sh - creates a Jenkins SSH key credential from a string or an SSH private key file
    • jenkins_cred_cli_add_user_pass.sh - creates a Jenkins username/password credential
    • jenkins_cred_cli_delete.sh - deletes a given Jenkins credential by id
    • jenkins_cred_cli_list.sh - lists Jenkins credentials IDs and Names
    • jenkins_cred_cli_update_cert.sh - updates a Jenkins certificate credential from a PKCS#12 keystore
    • jenkins_cred_cli_update_kubernetes_sa.sh - updates a Jenkins Kubernetes service account credential
    • jenkins_cred_cli_update_secret_file.sh - updates a Jenkins secret file credential from a file
    • jenkins_cred_cli_update_secret_text.sh - updates a Jenkins secret string credential from a string or a file
    • jenkins_cred_cli_update_ssh_key.sh - updates a Jenkins SSH key credential from a string or an SSH private key file
    • jenkins_cred_cli_update_user_pass.sh - updates a Jenkins username/password credential
    • jenkins_cred_cli_set_cert.sh - creates or updates a Jenkins certificate credential from a PKCS#12 keystore
    • jenkins_cred_cli_set_kubernetes_sa.sh - creates or updates a Jenkins Kubernetes service account credential
    • jenkins_cred_cli_set_secret_file.sh - creates or updates a Jenkins secret file credential from a file
    • jenkins_cred_cli_set_secret_text.sh - creates or updates a Jenkins secret string credential from a string or a file
    • jenkins_cred_cli_set_ssh_key.sh - creates or updates a Jenkins SSH key credential from a string or an SSH private key file
    • jenkins_cred_cli_set_user_pass.sh - creates or updates a Jenkins username/password credential
  • jenkins_password.sh - gets Jenkins admin password from local docker container. Used by jenkins_cli.sh
  • jenkins_plugins_latest_versions.sh - finds the latest versions of given Jenkins plugins. Useful to programmatically upgrade your Jenkins on Kubernetes plugins defined in values.yaml
  • check_jenkinsfiles.sh - validates all *Jenkinsfile* files in the given directory trees using the online Jenkins validator
  • See also Knowledge Base notes for Jenkins.
• teamcity/*.sh - TeamCity CI scripts:
  • teamcity.sh - one-touch TeamCity CI cluster:
    • launches Docker containers with server and 1 agent
    • click proceed and accept the EULA
    • waits for server to initialize
    • waits for agent to register
    • authorizes agent
    • creates a VCS Root if $PWD has a .teamcity.vcs.json / .teamcity.vcs.ssh.json / .teamcity.vcs.oauth.json and corresponding $TEAMCITY_SSH_KEY or $TEAMCITY_GITHUB_CLIENT_ID+$TEAMCITY_GITHUB_CLIENT_SECRET environment variables
    • creates a Project and imports all settings and builds from the VCS Root
    • creates an admin user and an API token for you
    • see also: TeamCity CI config repo for importing pipelines
  • teamcity_api.sh - queries TeamCity's API, auto-handling authentication and other quirks of the API
  • teamcity_create_project.sh - creates a TeamCity project using the API
  • teamcity_create_github_oauth_connection.sh - creates a TeamCity GitHub OAuth VCS connection in the Root project, useful for bootstrapping projects from VCS configs
  • teamcity_create_vcs_root.sh - creates a TeamCity VCS root from a save configuration (XML or JSON), as downloaded by teamcity_export_vcs_roots.sh
  • teamcity_upload_ssh_key.sh - uploads an SSH private key to a TeamCity project (for use in VCS root connections)
  • teamcity_agents.sh - lists TeamCity agents, their connected state, authorized state, whether enabled and up to date
  • teamcity_builds.sh - lists the last 100 TeamCity builds along with the their state (eg. finished) and status (eg. SUCCESS/FAILURE)
  • teamcity_buildtypes.sh - lists TeamCity buildTypes (pipelines) along with the their project and IDs
  • teamcity_buildtype_create.sh - creates a TeamCity buildType from a local JSON configuration (see teamcity_buildtypes_download.sh)
  • teamcity_buildtype_set_description_from_github.sh - sync's a TeamCity buildType's description from its Github repo description
  • teamcity_buildtypes_set_description_from_github.sh - sync's all TeamCity buildType descriptions from their GitHub repos where available
  • teamcity_export.sh - downloads TeamCity configs to local JSON files in per-project directories mimicking native TeamCity directory structure and file naming
  • teamcity_export_project_config.sh - downloads TeamCity project config to local JSON files
  • teamcity_export_buildtypes.sh - downloads TeamCity buildType config to local JSON files
  • teamcity_export_vcs_roots.sh - downloads TeamCity VCS root config to local JSON files
  • teamcity_projects.sh - lists TeamCity project IDs and Names
  • teamcity_project_set_versioned_settings.sh - configures a project to track all changes to a VCS (eg. GitHub)
  • teamcity_project_vcs_versioning.sh - quickly toggle VCS versioning on/off for a given TeamCity project (useful for testing without auto-committing)
  • teamcity_vcs_roots.sh - lists TeamCity VCS root IDs and Names
• travis/*.sh - Travis CI API scripts (one of my all-time favourite CI systems):
  • travis_api.sh - queries the Travis CI API with authentication using $TRAVIS_TOKEN
  • travis_repos.sh - lists Travis CI repos
  • travis_foreach_repo.sh - executes a templated command against all Travis CI repos
  • travis_repo_build.sh - triggers a build for the given repo
  • travis_repo_caches.sh - lists caches for a given repo
  • travis_repo_crons.sh - lists crons for a given repo
  • travis_repo_env_vars.sh - lists environment variables for a given repo
  • travis_repo_settings.sh - lists settings for a given repo
  • travis_repo_create_cron.sh - creates a cron for a given repo and branch
  • travis_repo_delete_crons.sh - deletes all crons for a given repo
  • travis_repo_delete_caches.sh - deletes all caches for a given repo (sometimes clears build problems)
  • travis_delete_cron.sh - deletes a Travis CI cron by ID
  • travis_repos_settings.sh - lists settings for all repos
  • travis_repos_caches.sh - lists caches for all repos
  • travis_repos_crons.sh - lists crons for all repos
  • travis_repos_create_cron.sh - creates a cron for all repos
  • travis_repos_delete_crons.sh - deletes all crons for all repos
  • travis_repos_delete_caches.sh - deletes all caches for all repos
  • travis_lint.sh - lints a given .travis.yml using the API
• buildkite/*.sh - BuildKite API scripts:
  • buildkite_api.sh - queries the BuildKite API, handling authentication using $BUILDKITE_TOKEN
  • buildkite_pipelines.sh - list buildkite pipelines for your $BUILDKITE_ORGANIZATION / $BUILDKITE_USER
  • buildkite_foreach_pipeline.sh - executes a templated command for each Buildkite pipeline, replacing the {user} and {pipeline} in each iteration
  • buildkite_agent.sh - runs a buildkite agent locally on Linux or Mac, or in Docker with choice of Linux distros
  • buildkite_agents.sh - lists the Buildkite agents connected along with their hostname, IP, started dated and agent details
  • buildkite_pipelines.sh - lists Buildkite pipelines
  • buildkite_create_pipeline.sh - create a Buildkite pipeline from a JSON configuration (like from buildkite_get_pipeline.sh or buildkite_save_pipelines.sh)
  • buildkite_get_pipeline.sh - gets details for a specific Buildkite pipeline in JSON format
  • buildkite_update_pipeline.sh - updates a BuildKite pipeline from a configuration provided via stdin or from a file saved via buildkite_get_pipeline.sh
  • buildkite_patch_pipeline.sh - updates a BuildKite pipeline from a partial configuration provided as an arg, via stdin, or from a file saved via buildkite_get_pipeline.sh
  • buildkite_pipeline_skip_settings.sh - lists the skip intermediate build settings for one or more given BuildKite pipelines
  • buildkite_pipeline_set_skip_settings.sh - configures given or all BuildKite pipelines to skip intermediate builds and cancel running builds in favour of latest build
  • buildkite_cancel_scheduled_builds.sh - cancels BuildKite scheduled builds (to clear a backlog due to offline agents and just focus on new builds)
  • buildkite_cancel_running_builds.sh - cancels BuildKite running builds (to clear them and restart new later eg. after agent / environment change / fix)
  • buildkite_pipeline_disable_forked_pull_requests.sh - disables forked pull request builds on a BuildKite pipeline to protect your build environment from arbitrary code execution security vulnerabilities
  • buildkite_pipelines_vulnerable_forked_pull_requests.sh - prints the status of each pipeline, should all return false, otherwise run the above script to close the vulnerability
  • buildkite_rebuild_cancelled_builds.sh - triggers rebuilds of last N cancelled builds in current pipeline
  • buildkite_rebuild_failed_builds.sh - triggers rebuilds of last N failed builds in current pipeline (eg. after agent restart / environment change / fix)
  • buildkite_rebuild_all_pipelines_last_cancelled.sh - triggers rebuilds of the last cancelled build in each pipeline in the organization
  • buildkite_rebuild_all_pipelines_last_failed.sh - triggers rebuilds of the last failed build in each pipeline in the organization
  • buildkite_retry_jobs_dead_agents.sh - triggers job retries where jobs failed due to killed agents, continuing builds from that point and replacing their false negative failed status with the real final status, slightly better than rebuilding entire jobs which happen under a new build
  • buildkite_recreate_pipeline.sh - recreates a pipeline to wipe out all stats (see url and badge caveats in --help)
  • buildkite_running_builds.sh - lists running builds and the agent they're running on
  • buildkite_save_pipelines.sh - saves all BuildKite pipelines in your $BUILDKITE_ORGANIZATION to local JSON files in $PWD/.buildkite-pipelines/
  • buildkite_set_pipeline_description.sh - sets the description of one or more pipelines using the BuildKite API
  • buildkite_set_pipeline_description_from_github.sh - sets a Buildkite pipeline description to match its source GitHub repo
  • buildkite_sync_pipeline_descriptions_from_github.sh - for all BuildKite pipelines sets each description to match its source GitHub repo
  • buildkite_trigger.sh - triggers BuildKite build job for a given pipeline
  • buildkite_trigger_all.sh - same as above but for all pipelines
• terraform_cloud_*.sh - Terraform Cloud API scripts:
  • terraform_cloud_api.sh - queries the Cloudflare API, handling authentication using $TERRAFORM_TOKEN
  • terraform_cloud_ip_ranges.sh - returns the list of IP ranges for Terraform Cloud
  • terraform_cloud_organizations.sh - lists Terraform Cloud organizations
  • terraform_cloud_workspaces.sh - lists Terraform Cloud workspaces
  • terraform_cloud_workspace_vars.sh - lists Terraform Cloud workspace variables
  • terraform_cloud_workspace_set_vars.sh - adds / updates Terraform workspace-level sensitive environment/terraform variable(s) via the API from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
  • terraform_cloud_workspace_delete_vars.sh - deletes one or more Terraform workspace-level variables
  • terraform_cloud_varsets.sh - lists Terraform Cloud variable sets
  • terraform_cloud_varset_vars.sh - lists Terraform Cloud variables in on or all variables sets for the given organization
  • terraform_cloud_varset_set_vars.sh - adds / updates Terraform sensitive environment/terraform variable(s) in a given variable set via the API from key=value or shell export format, as args or via stdin (eg. piped from aws_csv_creds.sh)
  • terraform_cloud_varset_delete_vars.sh - deletes one or more Terraform variables in a given variable set
• terraform_*.sh - Terraform scripts:
  • terraform_gcs_backend_version.sh - determines the Terraform state version from the tfstate file in a GCS bucket found in a local given backend.tf
  • terraform_gitlab_download_backend_variable.sh - downloads backend.tf from a GitLab CI/CD variable to be able to quickly iterate plans locally
  • terraform_import.sh - finds given resource type in ./*.tf code or Terraform plan output that are not in Terraform state and imports them
  • terraform_import_aws_iam_users.sh - parses Terraform plan output to import new aws_iam_user additions into Terraform state
  • terraform_import_aws_iam_groups.sh - parses Terraform plan output to import new aws_iam_group additions into Terraform state
  • terraform_import_aws_iam_policies.sh - parses Terraform plan output to import new aws_iam_policies additions, resolves their ARNs and imports them into Terraform state
  • terraform_import_aws_sso_permission_sets.sh - finds all aws_ssoadmin_permission_set in ./*.tf code, resolves the ARNs and imports them to Terraform state
  • terraform_import_aws_sso_account_assignments.sh - parses Terraform plan output to import new aws_ssoadmin_account_assignment additions into Terraform state
  • terraform_import_aws_sso_managed_policy_attachments.sh - parses Terraform plan output to import new aws_ssoadmin_account_assignment additions into Terraform state
  • terraform_import_aws_sso_permission_set_inline_policies.sh - parses Terraform plan output to import new aws_ssoadmin_permission_set_inline_policy additions into Terraform state
  • terraform_import_github_repos.sh - finds all github_repository in ./*.tf code or Terraform plan output that are not in Terraform state and imports them. See also github_repos_not_in_terraform.sh
  • terraform_import_github_team.sh - imports a given GitHub team into a given Terraform state resource, by first querying the GitHub API for the team ID needed to import into Terraform
  • terraform_import_github_teams.sh - finds all github_team in ./*.tf code or Terraform plan output that are not in Terraform state, then queries the GitHub API for their IDs and imports them. See also github_teams_not_in_terraform.sh
  • terraform_import_github_team_repos.sh - finds all github_team_repository in Terraform plan that would be added, then queries the GitHub API for the repos and team IDs and if they both exist then imports them to Terraform state
  • terraform_provider_count_sizes.sh - finds duplicate Terraform providers and their sizes. Useful to find space wastage caused by using Terragrunt without configuring a unified Terraform Plugin Cache
  • terraform_resources.sh - external program to get all resource ids and attribute for a given resource type to work around Terraform splat expression limitation (#19931)
  • terraform_managed_resource_types.sh - quick parse of what Terraform resource types are found in *.tf files under the current or given directory tree. Useful to give you a quick glance of what services you are managing
  • terraform_registry_url_extract.sh - extracts the Terraform Registry URL in either tfr:// or https://registry.terraform.io/ format from a given string, file or standard input. Useful to fast load Terraform Module documentation via editor/IDE hotkeys (see .vimrc). Based on urlextract.sh above
  • terraform_registry_url_to_https.sh - converts one or more Terraform Registry URLs from tfr:// to https://registry.terraform.io/ format
  • terraform_registry_url_open.sh - opens the Terraform Registry URL given as a string arg, file or standard input in either tfr:// or https://registry.terraform.io/ format
  • See also Knowledge Base notes for Terraform.
• checkov_resource_*.sh - Checkov resource counts - useful to estimate Bridgecrew Cloud costs which are charged per resource:
  • checkov_resource_count.sh - counts the number of resources Checkov is scanning in the current or given directory
  • checkov_resource_count_all.sh - counts the total number of resources Checkov is scanning across all given repo checkouts
• octopus_api.sh - queries the Octopus Deploy API
• sonarlint_generate_config.sh - generates the .sonarlint/connectedMode.json config at the root of the Git repo from the sonar-project.properties file

See also Knowledge Base notes for CI/CD.

ai/ and ipaas/ directories:

• openai_api.sh - queries the OpenAI (ChatGPT) API with authentication
• make_api.sh - queries the Make.com API with authentication

internet/, cloudflare/, pingdom/, terraform/ directories:

• Pastebins - uploads files and copies the resulting URL to your clipboard:
  • code / text only - prompts to approve text / code before upload for safety:
    • pastebin.sh - uploads a file to https://pastebin.com, script auto-determines which syntax highlighting to add since API doesn't auto infer
    • dpaste.sh - uploads a file to https://dpaste.com, script auto-determines which syntax highlighting to add since API doesn't auto infer
    • termbin.sh - uploads a file to https://termbin.com (site has no syntax highlighting)
  • all files, multimedia or text / code - prompts to approve text / code before upload for safety:
    • 0x0.sh - uploads a file to https://0x0.st (fast)
    • imgur.sh - uploads an image file to https://imgur.com
    • file.io.sh - uploads a file to https://file.io with 2 weeks, single download retention
    • catbox.sh - uploads a file to https://catbox.moe/ with permanent retention (slow)
    • litterbox.sh - uploads a file to https://litterbox.catbox.moe/ with temporary retention (slow)
• brave.sh - opens URL(s) in the Brave browser in a portable way between Linux and Mac for use from other scripts from args or stdin. You may want to combine this with the command_return_to_current_window.sh script when automating opening tabs
• brave_bookmark_urls.sh - parses the Brave browser bookmark URLs and prints them one per line. Supports different profiles and querying specific Bookmarks subfolders. Useful to combine with another tool like brave.sh to open all those tabs in a staggered throttled way in order to avoid overloading a website, which often results in HTTP 429 Too Many Requests errors and time banning
• digital_ocean_api.sh / doapi.sh - queries the Digital Ocean API with authentication
  • see also the Digital Ocean CLI doctl (install/install_doctl.sh)
• atlassian_ip_ranges.sh - lists Atlassian's IPv4 and/or IPv6 cidr ranges via its API
• circleci_public_ips.sh - lists CircleCI public IP addresses via dnsjson.com
• cloudflare_*.sh - Cloudflare API queries and reports:
  • cloudflare_api.sh - queries the Cloudflare API with authentication
  • cloudflare_ip_ranges.sh - lists Cloudflare's IPv4 and/or IPv6 cidr ranges via its API
  • cloudflare_custom_certificates.sh - lists any custom SSL certificates in a given Cloudflare zone along with their status and expiry date
  • cloudflare_dns_records.sh - lists any Cloudflare DNS records for a zone, including the type and ttl
  • cloudflare_dns_records_all_zones.sh - same as above but for all zones
  • cloudflare_dns_record_create.sh - creates a DNS record in the given domain
  • cloudflare_dns_record_update.sh - updates a DNS record in the given domain
  • cloudflare_dns_record_delete.sh - deletes a DNS record in the given domain
  • cloudflare_dns_record_details.sh - lists the details for a DNS record in the given domain in JSON format for further pipe processing
  • cloudflare_dnssec.sh - lists the Cloudflare DNSSec status for all zones
  • cloudflare_firewall_rules.sh - lists Cloudflare Firewall rules, optionally with filter expression
  • cloudflare_firewall_access_rules.sh - lists Cloudflare Firewall Access rules, optionally with filter expression
  • cloudflare_foreach_account.sh - executes a templated command for each Cloudflare account, replacing the {account_id} and {account_name} in each iteration (useful for chaining with cloudflare_api.sh)
  • cloudflare_foreach_zone.sh - executes a templated command for each Cloudflare zone, replacing the {zone_id} and {zone_name} in each iteration (useful for chaining with cloudflare_api.sh, used by adjacent cloudflare_*_all_zones.sh scripts)
  • cloudflare_purge_cache.sh - purges the entire Cloudflare cache
  • cloudflare_ssl_verified.sh - gets the Cloudflare zone SSL verification status for a given zone
  • cloudflare_ssl_verified_all_zones.sh - same as above for all zones
  • cloudflare_zones.sh - lists Cloudflare zone names and IDs (needed for writing Terraform Cloudflare code)
• chrome.sh - opens URL(s) in the Google Chrome browser in a portable way between Linux and Mac for use from other scripts from args or stdin. You may want to combine this with the command_return_to_current_window.sh script when automating opening tabs
• chrome_profiles.sh - parses Chrome brower's local state and lists the users and profile names to be passed to the chrome command when using automation like chrome.sh multi-url stdin staggered opening
• chrome_dump_dom.sh - uses Chrome in headless mode to dump the final HTML DOM from Javascript constructed pages to stdout for automated shell processing, such as piping to urlextract.sh or html_hrefs.sh to extract all HTTP(S) or generic links respectively
• chrome_bookmark_urls.sh - parses the Google Chrome bookmark URLs and prints them one per line. Supports different profiles and querying specific Bookmarks subfolders. Useful to combine with another tool like chrome.sh to open all those tabs in a staggered throttled way in order to avoid overloading a website, which often results in HTTP 429 Too Many Requests errors and time banning
• datadog_api.sh - queries the DataDog API with authentication
• dnsjson.sh - queries dnsjson.com for DNS records
• domains_subdomains_environments.sh - for a given list of domains, deduplicate and print dev / staging subdomains as well as root domain for prod. Used to generate a whole bunch of Ad Tech domains and pixel tracker subdomains for a project. Combine with markdown_columns_to_table.sh to generate the markdown documentation for your domains and subomains per project and environment
• gitguardian_api.sh - queries the GitGuardian API with authentication
• firefox.sh - opens URL(s) in the Firefox browser in a portable way between Linux and Mac for use from other scripts from args or stdin. You may want to combine this with the command_return_to_current_window.sh script when automating opening tabs
• google_maps_link.sh - queries for a search string, returns the first hit and then generates a stable fixed place ID url to the result. Useful for sharing in documentation links to places like HariSekhon/Knowledge-Base Travel pages
• jira_api.sh - queries Jira API with authentication
• kong_api.sh - queries the Kong API Gateway's Admin API, handling authentication if enabled
• traefik_api.sh - queries the Traefik API, handling authentication if enabled
• ngrok_api.sh - queries the NGrok API with authentication
• pingdom_*.sh - Pingdom API queries and reports for status, latency, average response times, latency averages by hour, SMS credits, outages periods and durations over the last year etc.
  • pingdom_api.sh - queries the Solarwinds Pingdom API with authentication
  • pingdom_foreach_check.sh - executes a templated command against each Pingdom check, replacing the {check_id} and {check_name} in each iteration
  • pingdom_checks.sh - show all Pingdom checks, status and latencies
  • pingdom_checks_outages.sh / pingdom_checks_outages.sh - show one or all Pingdom checks outage histories for the last year
  • pingdom_checks_average_response_times.sh - shows the average response times for all Pingdom checks for the last week
  • pingdom_check_latency_by_hour.sh / pingdom_checks_latency_by_hour.sh - shows the average latency for one or all Pingdom checks broken down by hour of the day, over the last week
  • pingdom_sms_credits.sh - gets the remaining number of Pingdom SMS credits
• terraform_cloud_api.sh - queries Terraform Cloud API with authentication
• terraform_cloud_ip_ranges.sh - returns the list of IP ranges for Terraform Cloud via the API, or optionally one or more of the ranges used by different functions
• wordpress.sh - boots Wordpress in docker with a MySQL backend, and increases the upload_max_filesize to be able to restore a real world sized export backup
• wordpress_api.sh - queries the Wordpress API with authentication
• wordpress_posts_without_category_tags.sh - checks posts (articles) for categories without corresponding tags and prints the posts and their missing tags

java/ directory:

• java_show_classpath.sh - shows Java classpaths, one per line, of currently running Java programs
• jvm_heaps*.sh - show all your Java heap sizes for all running Java processes, and their total MB (for performance tuning and sizing)
• Java Decompilers:
  • java_decompile_jar.sh - decompiles a Java JAR in /tmp, finds the main class and runs a Java decompiler on its main .class file using jd_gui.sh
  • jd_gui.sh - runs Java Decompiler JD GUI, downloading its jar the first time if it's not already present
  • bytecode_viwer.sh - runs Bytecode-Viewer GUI Java decompiler, downloading its jar the first time if it's not already present
  • cfr.sh - runs CFR command line Java decompiler, downloading its jar the first time if it's not already present
  • procyon.sh - runs Procyon command line Java decompiler, downloading its jar the first time if it's not already present

See also Knowledge Base notes for Java and JVM Performance Tuning.

python/ directory:

• python_compile.sh - byte-compiles Python scripts and libraries into .pyo optimized files
• python_pip_install.sh - bulk installs PyPI modules from mix of arguments / file lists / stdin, accounting for User vs System installs, root vs user sudo, VirtualEnvs / Anaconda / GitHub Workflows/ Google Cloud Shell, Mac vs Linux library paths, and ignore failure option
• python_pip_install_if_absent.sh - installs PyPI modules not already in Python libary path (OS or pip installed) for faster installations only where OS packages are already providing some of the modules, reducing time and failure rates in CI builds
• python_pip_install_for_script.sh - installs PyPI modules for given script(s) if not already installed. Used for dynamic individual script dependency installation in the DevOps Python tools repo
• python_pip_reinstall_all_modules.sh - reinstalls all PyPI modules which can fix some issues
• pythonpath.sh - prints all Python libary search paths, one per line
• python_find_library_path.sh - finds directory where a PyPI module is installed - without args finds the Python library base
• python_find_library_executable.sh - finds directory where a PyPI module's CLI program is installed (system vs user, useful when it gets installed to a place that isn't in your $PATH, where which won't help)
• python_find_unused_pip_modules.sh - finds PyPI modules that aren't used by any programs in the current directory tree
• python_find_duplicate_pip_requirements.sh - finds duplicate PyPI modules listed for install under the directory tree (useful for deduping module installs in a project and across submodules)
• python_translate_import_module.sh - converts Python import modules to PyPI module names, used by python_pip_install_for_script.sh
• python_translate_module_to_import.sh - converts PyPI module names to Python import names, used by python_pip_install_if_absent.sh and python_find_unused_pip_modules.sh
• python_pyinstaller.sh - creates PyInstaller self-contained Python programs with Python interpreter and all PyPI modules included
• python_pypi_versions.sh - prints all available versions of a given PyPi module using the API

See also Knowledge Base notes for Python.

perl/ directory:

• perl_cpanm_install.sh - bulk installs CPAN modules from mix of arguments / file lists / stdin, accounting for User vs System installs, root vs user sudo, Perlbrew / Google Cloud Shell environments, Mac vs Linux library paths, ignore failure option, auto finds and reads build failure log for quicker debugging showing root cause error in CI builds logs etc
• perl_cpanm_install_if_absent.sh - installs CPAN modules not already in Perl libary path (OS or CPAN installed) for faster installations only where OS packages are already providing some of the modules, reducing time and failure rates in CI builds
• perl_cpanm_reinstall_all.sh - re-installs all CPAN modules. Useful for trying to recompile XS modules on Macs after migration assistant from an Intel Mac to an ARM Silicon Mac leaves your home XS libraries broken as they're built for the wrong architecture
• perlpath.sh - prints all Perl libary search paths, one per line
• perl_find_library_path.sh - finds directory where a CPAN module is installed - without args finds the Perl library base
• perl_find_library_executable.sh - finds directory where a CPAN module's CLI program is installed (system vs user, useful when it gets installed to a place that isn't in your $PATH, where which won't help)
• perl_find_unused_cpan_modules.sh - finds CPAN modules that aren't used by any programs in the current directory tree
• perl_find_duplicate_cpan_requirements.sh - finds duplicate CPAN modules listed for install more than once under the directory tree (useful for deduping module installs in a project and across submodules)
• perl_generate_fatpacks.sh - creates Fatpacks - self-contained Perl programs with all CPAN modules built-in

See also Knowledge Base notes for Perl.

packages/ directory:

• golang_install.sh - bulk installs Golang modules from mix of arguments / file lists / stdin
• golang_install_if_absent.sh - same as above but only if the package binary isn't already available in $PATH
• golang_rm_binaries.sh - deletes binaries of the same name adjacent to .go files. Doesn't delete your bin/ etc as these are often real deployed applications rather than development binaries

Used in HariSekhon/Diagrams-as-Code

diagrams/ directory:

• d2.sh - generates a D2lang diagram, using its shebang if present for themes etc, and then opens the resulting image
• d2_generate_diagrams.sh - generates all D2lang .d2 diagrams found under the current or given directory, git reverting or deleting those that didn't generate properly (to work around d2lang issue #2367)
• mermaidjs_generate_diagrams.sh - generates all MermaidJS .mmd diagrams found under the current or given directory, git reverting or deleting those that didn't generate properly
• python_mingrammer_generate_diagrams.sh - generates all Python Mingrammer .py diagrams found under the current or given directory

media/ directory:

• image_shrink.sh - shrinks an image by resizing it (default 50%) to be able to upload it against limits on some websites. Shows the before and after stats and automatically opens the image to check it
• image_reduce_quality.sh - shrinks an image size by reducing its quality (default to 80%) to be able to upload it against limits on some websites. Shows the before and after stats and automatically opens the image to check it
• image_trim_pixels.sh - trims N pixels off one of the sides of an image. Useful to tweak screenshots before sharing them
• image_join_vertical.sh - joins two images top and bottom after matching their widths so they align correctly
• image_join_horizontal.sh - joins two images left and right after matching their heights so they align correctly
• imageopen.sh - opens the given image file using whatever available tool is found on Linux or Mac
• d2.sh - generates D2lang diagram and then opens the resulting image
• avif_to_png.sh - converts an Avif image to PNG to be usable on websites that don't support Webp images like LinkedIn
• svg_to_png.sh - converts an SVG image to PNG to be usable on websites that don't support SVG images like LinkedIn, Medium or Reddit
• webp_to_png.sh - converts a Webp image to PNG to be usable on websites that don't support Webp images like Medium. Tries 2 different tools for webp unlike the next generic converter
• image_to_png.sh - try to convert any image to PNG to be usable on fussy websites such as LinkedIn, Medium or Reddit

Each of these three scripts creates an animated Git from running terminal commands and then opens the resulting gif.

• ttygif.sh - uses ttyrec and ttygif
• asciinema.sh - uses asciinema and agg
• terminalizer.sh - uses Terminalizer

• mp3_set_artist.sh / mp3_set_album.sh - set the artist / album tag for all mp3 files under given directories. Useful for grouping artists/albums and audiobook author/books (eg. for correct importing into Mac's Books.app)
• mp3_set_track_name.sh - set the track name metadata for mp3 files under given directories to follow their filenames. Useful for correctly displaying audiobook progress / chapters etc.
• mp3_set_track_order.sh - set the track order metadata for mp3 files under given directories to follow the lexical file naming order. Useful for correctly ordering album songs and audiobook chapters (eg. for Mac's Books.app). Especially useful for enforcing global ordering on multi-CD audiobooks after grouping into a single audiobook using mp3_set_album.sh (otherwise default track numbers in each CD interleave in Mac's Books.app)

• avi_to_mp4.sh - converts avi files to mp4 using ffmpeg. Useful to be able to play videos on devices like smart TVs that may not recognize newer codecs otherwise
• mkv_to_mp4.sh - converts mkv files to mp4 using ffmpeg. Same use case as above
• mp4_to_aac_audio_mp4.sh - converts mp4 files to aac audio using ffmpeg. Useful for files that won't play audio on macOS QuickTime otherwise
• mp4_to_mov.sh - quickly repackages mp4 files to mov using ffmpeg. Useful for files that won't play audio on macOS QuickTime so you can edit the mov in QuickTime
• youtube_download_video.sh - downloads a YouTube video to mp4 with maximum quality and compatibility usng yt-dlp
  • facebook_download_video.sh - same as above for Facebook
  • twitter_download_video.sh - same as above for Twitter / X
  • x_download_video.sh - same as above for X / Twitter
• youtube_download_channel.sh - downloads all videos from a given YouTube channel using yt-dlp
• youtube_download_queue_add.sh - add YouTube or other supported social media URLs for the related adjacent scripts to a durable local queue for parallel recoverable download processing, thereby avoiding throttling errors from too many parallel instant downloads
• youtube_download_queue_process.sh - takes the next item from the download queue and calls youtube_download_video.sh on it
• video_to_720p_mp4 - converts one or more video files to 720p mp4 format using ffmpeg. Useful to make good trade-off of quality vs size for social media sharing
• video_to_480p_mp4 - symlink to above script converts to 480p mp4 format
• vidopen.sh - opens the given video file using whatever available tool is found on Linux or Mac

See also Knowledge Base notes for MultiMedia.

40+ Spotify API scripts (used extensively to manage my Spotify-Playlists repo).

spotify/ directory:

• spotify_playlists*.sh - list playlists in either <id> <name> or JSON format
• spotify_playlist_tracks*.sh - gets playlist contents as track URIs / Artists - Track / CSV format - useful for backups or exports between music systems
• spotify_backup.sh - backs up all Spotify playlists as well as the ordered list of playlists
• spotify_backup_playlist*.sh - backs up Spotify playlists to local files in both human readable Artist - Track format and Spotify URI format for easy restores or adding to new playlists
• spotify_backup_artists_followed.sh - backs up the list of artists followed to Spotify URI and Names
• spotify_search*.sh - searches Spotify's library for tracks / albums / artists getting results in human readable format, JSON, or URI formats for easy loading to Spotify playlists
  • spotify_search_json.sh - searches the Spotify API and returns the JSON of the first N tracks / artists / albums that match the given search expression
  • spotify_search.sh - same as above but returns just the Artist and Track name
  • spotify_search_uri.sh - same as above but returns the Spotify URI for further processing or copying straight into a playlist (can be auto-loaded to a playlist by chaining with spotify_add_to_playlist.sh below)
  • spotify_search_local_tracks.sh - searches the Spotify API for the given local track URI(s) and returns the first Spotify URI match for each track. Useful to quickly replace local tracks with Spotify official tracks by copying the output URIs into playlists
  • spotify_search_alternate_track_uris.sh - for given URI(s) returns the alternate track URIs that have the same Artist + Track name
• spotify_release_year.sh - searches for a given track or album and finds the original release year
• spotify_uri_json.sh - takes a Spotify URI and dumps its JSON for inspection. You can pass one of the following formats: spotify:<type>:<alphanumeric_ID>, http://open.spotify.com/<type>/<alphanumeric_ID>, <alphanumeric_ID>
• spotify_uri_to_name.sh - converts Spotify track / album / artist URIs to human readable Artist - Track or CSV format. Takes Spotify URIs, URL links or just IDs similar to spotify_uri_json.sh above. Reads URIs from files or standard input
• spotify_url_to_uri.sh - converts Spotify track / album / artist open URLs to shorter Spotify URIs (useful to work with offline playlist comparisons)
• spotify_create_playlist.sh - creates a Spotify playlist, either public or private
• spotify_rename_playlist.sh - renames a Spotify playlist
• spotify_set_playlists_public.sh / spotify_set_playlists_private.sh - sets one or more given Spotify playlists to public / private
• spotify_add_to_playlist.sh - adds tracks to a given playlist. Takes a playlist name or ID and Spotify URIs in any form from files or standard input. Can be combined with many other tools listed here which output Spotify URIs, or appended from other playlists. Can also be used to restore a spotify playlist from backups
• spotify_add_filelist_to_playlist.sh - searches the Spotify API for each track in a given file and adds the first matching track to the given playlist
• spotify_delete_from_playlist.sh - deletes tracks from a given playlist. Takes a playlist name or ID and Spotify URIs in any form from files or standard input, optionally prefixed with a track position to remove only specific occurrences (useful for removing duplicates from playlists)
• spotify_delete_from_playlist_if_in_other_playlists.sh - deletes tracks from a given playlist if their URIs are found in the subsequently given playlists
• spotify_delete_from_playlist_if_track_in_other_playlists.sh - deletes tracks from a given playlist if their 'Artist - Track' name match are found in the subsequently given playlists (less accurate than exact URI deletion above)
• spotify_duplicate_uri_in_playlist.sh - finds duplicate Spotify URIs in a given playlist (these are guaranteed exact duplicate matches), returns all but the first occurrence and optionally their track positions (zero-indexed to align with the Spotify API for easy chaining with other tools)
• spotify_duplicate_tracks_in_playlist.sh - finds duplicate Spotify tracks in a given playlist (these are idential Artist - Track name matches, which may be from different albums / singles)
• spotify_delete_duplicate_tracks_in_playlist.sh - deletes duplicate Spotify tracks (name matched) in a given playlist using spotify_duplicate_tracks_in_playlist.sh and spotify_delete_from_playlist.sh
• spotify_delete_duplicate_track_uris_in_playlist.sh - deletes duplicate Spotify URI tracks (identical) in a given playlist using spotify_duplicate_uri_in_playlist.sh and spotify_delete_from_playlist.sh
• spotify_delete_any_duplicates_in_playlist.sh - calls both of the above scripts to first get rid of duplicate URIs and then remove any other duplicates by track name matches
• spotify_playlist_tracks_uri_in_year.sh - finds track URIs in a playlist where their original release date is in a given year or decade (by regex match). This has to do a secondary Spotify track search lookup by name and relies on normalize_tracknames.pl from HariSekhon/Spotify-tools being built and in the $PATH
• spotify_playlist_tracks_uri_by_year.sh - returns track URIs from the given Spotify playlist for a specific year or range of years. Useful for filtering tracks to add to my best of each decade playlists. More efficient than spotify_playlist_tracks_uri_in_year.sh, without dependency on HariSekhon/Spotify-tools, but it only uses the year of the track version, which if an album track may not be the same year if it was first released as a single earlier
• spotify_playlist_tracks_uri_batch_by_year.sh - Returns all track URIs from the given Spotify playlist(s) grouped by year or decade. Copies each batch to the clipboard, prints to stdout, and prompts to continue before printing the next batch. Useful for filtering tracks to add to my best of each year or decade playlists
• spotify_playlist_uri_offset.sh - finds the offset of a given track URI in a given playlist, useful to find positions to resume processing a large playlist
• spotify_top_artists*.sh - lists your top artists in URI or human readable format
• spotify_top_tracks*.sh - lists top tracks in URI or human readable format
• spotify_playlist_top_artists.sh - returns the top artists for a given Spotify playlist by counting unique track names for each artist. If HariSekhon/Spotify-tools is in the $PATH it uses normalize_tracknames.pl for greater accuracy to collapse multiple versions such as Radio Edit and Album Version to only count that same song once
• spotify_liked_tracks*.sh - lists your Liked Songs in URI or human readable formats
• spotify_liked_artists*.sh - list artists from Liked Songs in URI or human readable formats
• spotify_artists_followed*.sh - lists all followed artists in URI or human readable formats
• spotify_artist_discography.sh- lists the core discography of Albums and Singles for a given Spotify artist in chronological order
• spotify_artist_tracks.sh - gets all track URIs for a given artist, from both albums and singles for chain loading to playlists
• spotify_follow_artists.sh - follows artists for the given URIs from files or standard input
• spotify_follow_top_artists.sh - follows all artists in your current Spotify top artists list
• spotify_follow_liked_artists.sh - follows artists with N or more tracks in your Liked Songs
• spotify_set_tracks_uri_to_liked.sh - sets a list of spotify track URIs to 'Liked' so they appear in the Liked Songs playlist. Useful for marking all the tracks in your best playlists as favourite tracks, or for porting historical Starred tracks to the newer Liked Songs
• spotify_foreach_playlist.sh - executes a templated command against all playlists, replacing {playlist} and {playlist_id} in each iteration
• spotify_playlist_name_to_id.sh / spotify_playlist_id_to_name.sh - convert playlist names <=> IDs
• spotify_playlist_snapshot_id.sh - returns the Snapshot ID of a given Spotify playlist, useful for detecting whether a playlist has changed or not to skip re-downloading it
• spotify_api_token.sh - gets a Spotify authentication token using either Client Credentials or Authorization Code authentication flows, the latter being able to read/modify private user data, automatically used by spotify_api.sh
• spotify_api.sh - query any Spotify API endpoint with authentication, used by adjacent spotify scripts

bin/, install/, packages/, setup/ directories:

• Linux / Mac systems administration scripts:
  • install/ - installation scripts for various OS packages (RPM, Deb, Apk) for various Linux distros (Redhat RHEL / CentOS / Fedora, Debian / Ubuntu, Alpine)
  • install if absent scripts for Python, Perl, Ruby, NodeJS and Golang packages - good for minimizing the number of source code installs by first running the OS install scripts and then only building modules which aren't already detected as installed (provided by system packages), speeding up builds and reducing the likelihood of compile failures
  • install scripts for tarballs, Golang binaries, random 3rd party installers, Jython and build tools like Gradle and SBT for when Linux distros don't provide packaged versions or where the packaged versions are too old
  • packages/ - OS / Distro Package Management:
    • install_packages.sh - installs package lists from arguments, files or stdin on major linux distros and Mac, detecting the package manager and invoking the right install commands, with sudo if not root. Works on RHEL / CentOS / Fedora, Debian / Ubuntu, Alpine, and Mac Homebrew. Leverages and supports all features of the distro / OS specific install scripts listed below
    • install_packages_if_absent.sh - installs package lists if they're not already installed, saving time and minimizing install logs / CI logs, same support list as above
    • Redhat RHEL / CentOS:
      • yum_install_packages.sh / yum_remove_packages.sh - installs RPM lists from arguments, files or stdin. Handles Yum + Dnf behavioural differences, calls sudo if not root, auto-attempts variations of python/python2/python3 package names. Avoids yum slowness by checking if rpm is installed before attempting to install it, accepts NO_FAIL=1 env var to ignore unavailable / changed package names (useful for optional packages or attempts for different package names across RHEL/CentOS/Fedora versions)
      • yum_install_packages_if_absent.sh - installs RPMs only if not already installed and not a metapackage provided by other packages (eg. vim metapackage provided by vim-enhanced), saving time and minimizing install logs / CI logs, plus all the features of yum_install_packages.sh above
      • yum_upgrade_packages_if_outdated.sh - upgrades RPMs only if they're outdated
      • rpms_filter_installed.sh / rpms_filter_not_installed.sh - pipe filter packages that are / are not installed for easy script piping
    • Debian / Ubuntu:
      • apt_install_packages.sh / apt_remove_packages.sh - installs Deb package lists from arguments, files or stdin. Auto calls sudo if not root, accepts NO_FAIL=1 env var to ignore unavailable / changed package names (useful for optional packages or attempts for different package names across Debian/Ubuntu distros/versions)
      • apt_install_packages_if_absent.sh - installs Deb packages only if not already installed, saving time and minimizing install logs / CI logs, plus all the features of apt_install_packages.sh above
      • apt_upgrade_packages_if_outdated.sh - upgrades Deb packages only if they're outdated
      • apt_wait.sh - blocking wait on concurrent apt locks to avoid failures and continue when available, mimicking yum's waiting behaviour rather than error'ing out
      • debs_filter_installed.sh / debs_filter_not_installed.sh - pipe filter packages that are / are not installed for easy script piping
    • Alpine:
      • apk_install_packages.sh / apk_remove_packages.sh - installs Alpine apk package lists from arguments, files or stdin. Auto calls sudo if not root, accepts NO_FAIL=1 env var to ignore unavailable / changed package names (useful for optional packages or attempts for different package names across Alpine versions)
      • apk_install_packages_if_absent.sh - installs Alpine apk packages only if not already installed, saving time and minimizing install logs / CI logs, plus all the features of apk_install_packages.sh above
      • apk_upgrade_packages_if_outdated.sh - upgrades Alpine apk packages only if they're outdated
      • apk_filter_installed.sh / apk_filter_not_installed.sh - pipe filter packages that are / are not installed for easy script piping
    • Mac:
      • brew_install_packages.sh / brew_remove_packages.sh - installs Mac Hombrew package lists from arguments, files or stdin. Accepts NO_FAIL=1 env var to ignore unavailable / changed package names (useful for optional packages or attempts for different package names across versions)
      • brew_install_packages_if_absent.sh - installs Mac Homebrew packages only if not already installed, saving time and minimizing install logs / CI logs, plus all the features of brew_install_packages.sh above
      • brew_upgrade_packages_if_outdated.sh - upgrades Mac Homebrew packages only if they're outdated
      • brew_filter_installed.sh / brew_filter_not_installed.sh - pipe filter packages that are / are not installed for easy script piping
      • brew_package_owns.sh - finds which brew package owns a given filename argument
• all builds across all my GitHub repos now make system-packages before make pip / make cpan to shorten how many packages need installing, reducing chances of build failures

bin/, checks/, cicd/ or language specific directories:

• lint.sh - lints one or more files, auto-determines the file types, parses lint headers and calls appropriate scripts and tools. Integrated with my custom .vimrc
• run.sh - runs one or more files, auto-determines the file types, any run or arg headers and executes each file using the appropriate script or CLI tool. Integrated with my custom .vimrc
• check_*.sh - extensive collection of 60+ generalized tests
  • run against all my GitHub repos via CI
  • check_internet.sh - useful, waits for internet connectivity before proceeding, multiple levels of checks on gateway, DNS, public IP and public domains
    • I use in my HariSekhon/Spotify-Playlists API downloads
  • Programming language linting:
    • Python (syntax, pep8, byte-compiling, reliance on asserts which can be disabled at runtime, except/pass etc.)
    • Perl
    • Java
    • Scala
    • Ruby
    • Bash / Shell
    • Misc (whitespace, README, custom code checks etc.)
  • Data & Markup:
    • JSON
    • CSON
    • XML
    • YAML
  • Build Systems:
    • Make
    • Maven
    • SBT
    • Gradle
  • CI linting:
    • Jenkinsfiles
    • GitLab CI
    • Circle CI
    • Travis CI
    • Concourse
    • Codefresh
  • Containerization & Virtualization:
    • Dockerfiles
    • Docker Compose
    • Kubernetes yaml & Kustomization
    • Vagrantfiles

Optional, only if you don't do the full make install.

Install only OS system package dependencies and AWS CLI via Python Pip (doesn't symlink anything to $HOME):

make

Adds sourcing to .bashrc and .bash_profile and symlinks dot config files to $HOME (doesn't install OS system package dependencies):

make link

undo via

make unlink

Install only OS system package dependencies (doesn't include AWS CLI or Python packages):

make system-packages

Install AWS CLI:

make aws

Install Azure CLI:

make azure

Install GCP GCloud SDK (includes CLI):

make gcp

Install GCP GCloud Shell environment (sets up persistent OS packages and all home directory configs):

make gcp-shell

Install generically useful Python CLI tools and modules (includes AWS CLI, autopep8 etc):

make python

> make help

 Usage:

  Common Options:

    make help                   show this message
    make build                  installs all dependencies - OS packages and any language libraries via native tools eg. pip, cpanm, gem, go etc that are not available via OS packages
    make build-retry            retries 'make build' x 3 until success to try to mitigate temporary upstream repo failures triggering false alerts in CI systems
    make ci                     prints env, then runs 'build-retry' for more resilient CI builds with debugging
    make printenv               prints environment variables, CPU cores, OS release, $PWD, Git branch, hashref etc. Useful for CI debugging
    make system-packages        installs OS packages only (detects OS via whichever package manager is available)
    make test                   run tests
    make clean                  removes compiled / generated files, downloaded tarballs, temporary files etc.

    make submodules             initialize and update submodules to the right release (done automatically by build / system-packages)
    make init                   same as above, often useful to do in CI systems to get access to additional submodule provided targets such as 'make ci'

    make cpan                   install any modules listed in any cpan-requirements.txt files if not already installed

    make pip                    install any modules listed in any requirements.txt files if not already installed

    make python-compile         compile any python files found in the current directory and 1 level of subdirectory
    make pycompile

    make github                 open browser at github project
    make readme                 open browser at github's README
    make github-url             print github url and copy to clipboard
    make status                 open browser at Github CI Builds overview Status page for all projects

    make ls                     print list of code files in project
    make wc                     show counts of files and lines

  Repo specific options:

    make install                builds all script dependencies, installs AWS CLI, symlinks all config files to $HOME and adds sourcing of bash profile

    make link                   symlinks all config files to $HOME and adds sourcing of bash profile
    make unlink                 removes all symlinks pointing to this repo's config files and removes the sourcing lines from .bashrc and .bash_profile

    make python-desktop         installs all Python Pip packages for desktop workstation listed in setup/pip-packages-desktop.txt
    make perl-desktop           installs all Perl CPAN packages for desktop workstation listed in setup/cpan-packages-desktop.txt
    make ruby-desktop           installs all Ruby Gem packages for desktop workstation listed in setup/gem-packages-desktop.txt
    make golang-desktop         installs all Golang packages for desktop workstation listed in setup/go-packages-desktop.txt
    make nodejs-desktop         installs all NodeJS packages for desktop workstation listed in setup/npm-packages-desktop.txt

    make desktop                installs all of the above + many desktop OS packages listed in setup/

    make mac-desktop            all of the above + installs a bunch of major common workstation software packages like Ansible, Terraform, MiniKube, MiniShift, SDKman, Travis CI, CCMenu, Parquet tools etc.
    make linux-desktop

    make ls-scripts             print list of scripts in this project, ignoring code libraries in lib/ and .bash.d/

    make github-cli             installs GitHub CLI
    make kubernetes             installs Kubernetes kubectl and kustomize to ~/bin/
    make terraform              installs Terraform to ~/bin/
    make vim                    installs Vundle and plugins
    make tmux                   installs TMUX TPM and plugin for kubernetes context
    make ccmenu                 installs and (re)configures CCMenu to watch this and all other major HariSekhon GitHub repos
    make status                 open the Github Status page of all my repos build statuses across all CI platforms

    make aws                    installs AWS CLI tools
    make azure                  installs Azure CLI
    make gcp                    installs Google Cloud SDK
    make digital-ocean          installs Digital Ocean CLI

    make aws-shell              sets up AWS Cloud Shell: installs core packages and links configs
                                (maintains itself across future Cloud Shells via .aws_customize_environment hook)
    make gcp-shell              sets up GCP Cloud Shell: installs core packages and links configs
                                (maintains itself across future Cloud Shells via .customize_environment hook)
    make azure-shell            sets up Azure Cloud Shell (limited compared to gcp-shell, doesn't install OS packages since there is no sudo)

Now exiting usage help with status code 3 to explicitly prevent silent build failures from stray 'help' arguments
make: *** [help] Error 3

(make help exits with error code 3 like most of my programs to differentiate from build success to make sure a stray help argument doesn't cause silent build failure with exit code 0)

git.io/bash-tools

The rest of my original source repos are here.

Pre-built Docker images are available on my DockerHub and can be re-generated using the my Dockerfiles repo.