git.io/bash-tools
1000多个DevOps Shell脚本和高级bash环境。
快速,先进的系统工程,自动化,API,较短的CLI等。
大量用于许多GitHub存储库,数十个Dockerhub构建(Dockerfiles)和600多个CI构建。
/path/endpoint即可快速查询流行的API.bashrc + .bash.d/*.sh别名,功能,着色,动态git&shell行为增强功能,安装的自动路径以及Python,Perl,Perl,Ruby,Ruby,Nodejs,Nodejs,Golang,Linux跨Linux分布和Mac。请参阅.bash.d/readme.mdinstall/ - 包含许多用于流行开源软件的安装脚本,并从GitHub版本中直接下载二进制下载configs/ - 包含许多通用技术的点配置setup/ - 包含设置脚本,软件包列表,额外的配置,Mac OS X设置等。.bash.d/ - 交互式库lib/ - 脚本和CI库另请参阅:其他语言中的类似DevOps存储库
Hari Sekhon
云与大数据承包商,英国
(前卢德拉,前Hortonworks顾问)
(欢迎您在LinkedIn上与我联系)
要引导程序,安装软件包并链接到您的shell配置文件以继承所有配置,请执行:
curl -L https://git.io/bash-bootstrap | sh.bashrc / .bash_profile中以自动继承所有技术的所有.bash.d/*.sh环境增强功能(请参见下面的清单).* config dotfiles to $HOME for git,vim,top,htop,屏幕,屏幕,tmux,editorconfig,ansible,postgresql .psqlrc等(仅当它们不存在时,因此与您自己的配置没有冲突)要仅安装包装依赖项以运行脚本,只需cd到GIT Clone Directory并运行make :
git clone https://github.com/HariSekhon/DevOps-Bash-tools bash-tools
cd bash-tools
make make install设置您的外壳配置文件以源别源。有关更多安装/卸载选项,请参见下面的单个设置零件。
.gitconfig , .vimrc , .screenrc , .tmux.conf , .toprc , .gitignore ....bashrc , .bash.d/ Interactive Library, lib/脚本库.psqlrc顶级互补和configs/目录:
.* - 许多常见软件的点conf文件,例如。 Advanced .vimrc , .gitconfig ,Massive .gitignore , .editorconfig , .screenrc , .tmux.conf等。.vimrc包含许多很棒的VIM调整,以及用于覆盖许多不同文件类型的热键,包括Python,Perl,Bash / bash / bash / shell,Dockerfiles,JSON,JSON,YAML,XML,XML,CSV,INI / properties / properties / properties Files,LDAP LDIF等,而无需离开Editor!.screenrc花式屏幕配置,包括高级颜色栏,大型历史记录,重新键入,自动空白等。.tmux.conf.gitconfig高级git配置.gitignore顶级.bashrc和.bash.d/ Directory:
.bashrc .bash.d/*.sh.bash.d/*.shmake bash link link .bashrc / .bash_profile $HOME .*lib/*.sh -bash实用程序库,充满了Docker,环境,CI检测(Travis CI,Jenkins等),端口和HTTP URL可用性内容检查等功能。从我所有的所有其他GitHub存储库中获取,以使设置Dockerized测试更容易。install/install_*.sh各种易于使用的安装脚本,用于以下常见技术 bin/目录:
login.sh登录到主要云平台如果在环境中找到其凭据,例如AWS,GCP,Azure,Github等CLIS ... DOCKER注册表:Dockerhub,GHCR,ECR,GCR,GCR,GAR,ACR,ACR,GITLAB,GITLAB,QUAY ... ...clean_caches.sh清理OS软件包和编程语言缓存 - 可用于节省空间或减少Docker图像大小delete_duplicate_files.sh用(n)后缀删除重复文件,通常是由Web浏览器下载引起的,在给定或当前目录中。检查它们是匹配的Basename文件的确切重复,没有(n)后缀,并具有完全相同的校验和安全性。提示要删除每个文件。要自动删除删除,请yes | delete_duplicate_files.sh 。这是清理您的~/Downloads目录的快速方法,可以放置您的用户crontabdownload_url_file.sh使用没有clobber的WGET从URL下载文件,并继续支持,或者使用原子替换卷曲以避免比赛条件。由github/github_download_release_file.sh , github_download_release_jar.sh使用,然后install/download_*_jar.shcurl_auth.sh通过自动加载oauth2 / jwt api代币或用户名和密码来缩短curl命令,从环境变量或通过RAM文件描述符通过互动的星级密码提示提示,以避免将它们放在命令行上(这会将其放置在过程列表中的凭据或OS审核日志文件中)。许多其他相邻的API查询脚本使用find_duplicate_files*.sh在给定目录树中按大小和/或校验和/或校验和校验树查找重复的文件。校验和仅在已经具有匹配字节计数的文件上完成,以提高效率find_broken_links.sh查找带有延迟的破裂链接,以避免绊倒防御find_broken_symlinks.sh查找指向不存在文件/目录的损坏的符号链接find_lock.sh试图通过在提示之前和之后查找文件列表的快照,以查找在给定或当前工作目录中使用的锁紧文件,您应该打开/关闭应用程序http_duplicate_urls.sh在给定的网页中查找重复的URLldapsearch.sh通过从环境变量推断开关来缩短ldapsearch命令ldap_user_recurse.sh / ldap_group_recurse.sh向上重复Active Directory LDAP用户以查找所有母体组,或向下查找所有嵌套用户(可用于调试LDAP集成和基于组的权限))linux_distro_versions.sh快速返回给定Linux发行版的主要版本列表diff_line_threshold.sh比较两个文件与线计数差异阈值,以确定它们是否完全不同。用于避免覆盖不仅仅是更新的文件,而是完全不同的文件organize_downloads.sh移动$ $HOME/Downloads/ $HOME/Downloads目录中众所周知的扩展名的文件,以大于1周copy_to_clipboard.sh在Linux或Mac上复制stdin或String arg to System剪贴板paste_from_clipboard.sh从系统剪贴板粘贴到Linux或Mac上的Stdoutpaste_diff_settings.sh拍摄剪贴板更改之前和之后的快照,并分散它们以显示配置更改processes_ram_sum.sh总结所有与GB中给定的正则拨号与一个小数点相匹配的所有进程的RAM使用pldd.sh Linux上的PRARS /proc显示了程序PID正在使用的.so加载的动态共享库。运行时等效于经典静态ldd命令,并且因为系统pldd命令通常无法连接到一个过程random_select.sh随机选择给定的ARG之一。对于采样,运行大型测试套件等的随机子集有用。random_number.sh在两个整数参数之间打印一个随机整数(包含)random_string.sh打印给定长度的随机字母数字字符串shields_embed_logo.sh基本64编码给定的图标文件或URL并打印logo=... URL参数您需要添加shields.io徽章URLshred_file.sh在删除该文件之前,将文件覆盖7次以防止恢复敏感信息shred_free_space.sh覆盖自由空间,以防止已删除的文件恢复敏感信息split.sh将大文件拆分为n个零件(默认为CPU内核的数量)以并行化对其的操作ssl_get_cert.sh获取一个远程host:port服务器的SSL CERT,以您可以管道,保存和在本地使用,例如在Java Trustsorts中ssl_verify_cert.sh验证远程SSL证书(战斗测试了更多功能富版本check_ssl_cert.pl ,都存在于高级Nagios插件库中)ssl_verify_cert_by_ip.sh验证特定IP地址上的SSL证书,可用于测试CDN的SSL源地址,例如Cloudflare代理源,然后启用端到端的SSL全部图片模式,以供端到端,或参见Kubernetes Ingresses(另请参见curl_k8s_ingress.sh )ttygif.sh使用ttyrec和ttygif从运行终端命令创建一个gif,然后打开结果的gifasciinema.sh使用asciinema和agg创建一个从运行终端命令中创建GIF,然后打开所得的GIFterminalizer.sh使用终端器从运行终端命令创建一个GIF,然后打开所得的GIFurlencode.sh / urldecode.sh url在命令行,管道等上快速编码 /解码urlextract.sh从给定的字符串arg,文件或标准输入中提取URLurlopen.sh打开作为ARG给出的URL,或从STDIN或给定文件中找到的第一个URL。使用系统的默认浏览器vagrant_hosts.sh生成/etc/hosts从Vagrantfile输出vagrant_total_mb.sh计算Vagrantfile中VMS的RAM另请参见Linux和Mac的知识基础。
Mac自动化脚本以自动化Mac UI和设置
bin/目录:
mac_diff_settings.sh在UI设置更改的快照之前和之后进行更改,并使它们易于找到defaults键以添加到setup/mac_settings.sh以保存设置mac_iso_to_usb.sh将给定的ISO文件转换为USB启动图像,并将其刻录到给定或检测到的插入USB驱动器上copy_to_clipboard.sh在Linux或Mac上复制stdin或String arg to System剪贴板paste_from_clipboard.sh从系统剪贴板粘贴到Linux或Mac上的Stdoutpaste_diff_settings.sh拍摄剪贴板更改之前和之后的快照,并分散它们以显示配置更改applescript/ Directory:
keystrokes.sh发送n击键组合mouse_clicks.sh将n鼠标单击组合到屏幕坐标的顺序get_mouse_coordinates.sh打印当前的鼠标坐标 - 知道要传递到上面的脚本mouse_clicks_remote_desktop.sh切换到Microsoft Remote桌面,等待10秒钟,然后单击每分钟一次鼠标以防止屏幕保护程序打开。解决Active Directory组策略的解决方法,这些策略无法禁用屏幕保护程序。将鼠标指向没有鼠标点击效果的区域,即终端的CMD-TAB并运行此get_frontmost_process_title.scpt检测最前面的窗口set_frontmost_process.scpt切换以将给定的应用带到前景,以发送击键 /鼠标单击到它browser_get_default.scpt获取可将默认配置的浏览器以格式传递到applescript(上述脚本)is_screen_locked.py检测屏幕是否锁定以停止发送击键或鼠标单击is_screensaver_running.scpt检测屏幕保护程序是否正在运行以停止发送击键或鼠标单击screensaver_activate.scpt激活屏幕保护程序另请参见Harisekhon/知识库中的Mac页面。
monitoring/目录:
dump_stats.sh将通用命令输出转输给本地tarball中的文本文件。对于收集供应商支持案例的支持信息有用grafana_api.sh与身份验证查询Grafana APIlog_timestamp_large_intervals.sh找到其时间戳间隔超过给定秒数的日志线,并输出这些日志线,其中最后一个时间戳和当前时间戳之间的差异。有助于查找从ci/cd日志等日志文件中花费很长时间的操作prometheus.sh在本地启动Prometheus,如果在$PATH中找到的话,下载它prometheus_docker.sh使用docker-compose在Docker中开始Prometheusprometheus_node_exporter.sh启动Prometheus node_exporter本地下载,如果在$PATH中找不到的话ssh_dump_stats.sh使用ssh和dump_stats.sh将公共命令输出从远程服务器转移到本地TARBALL。对供应商支持案例有用ssh_dump_logs.sh使用ssh将日志从服务器转移到本地文本文件,以上传到供应商支持案例请参阅Harisekhon/grafana,Prometheus,opentsDB,InfluxDB等的DOC页面。
mysql/ , postgres/ , sql/ and bin/目录:
sqlite.sh一键式sqlite,启动带有“奇努克”数据库的sqlite3 shell已加载mysql*.sh mysql脚本:mysql.sh缩短mysql命令,通过从两个标准环境变量(例如$MYSQL_TCP_PORT , $DBI_USER , $MYSQL_PWD (请参阅doc)和其他常见的环境变量(如$MYSQL_HOST / $HOST / $ spositys $MYSQL_USER , $USER , $MYSQL_PASSWORD , $PASSWORD , $MYSQL_DATABASE / $DATABASEmysql_foreach_table.sh对每个表执行SQL查询,在每个迭代中替换{db}和{table} 。 select count(*) from {table}mysql_*.sh使用mysql.sh进行行计数,迭代每个表或输出清洁数据库和表的清洁列表以快速脚本mysqld.sh一键mysql,靴子docker容器 +插入mysql shell,其中/sql脚本安装在容器中,以易于采购。 source /sql/<name>.sql 。可选地加载样本“ Chinook”数据库mariadb.sh一键式Mariadb,Boots Docker Container +落入mysql Shell,并将/sql脚本安装在容器中,以易于采购。 source /sql/<name>.sql 。可选地加载样本“ Chinook”数据库postgres*.sh / psql.sh postgresql脚本:postgres.sh一键式的postgresql,靴子码头容器 +滴入psql shell,其中/sql脚本安装在容器中,以易于采购。 i /sql/<name>.sql 。可选地加载样本“ Chinook”数据库psql.sh使用来自环境变量的自动装满开关来缩短psql命令,使用标准的邮政为环境变量(例如$PG* (请参阅doc)以及其他常见的环境变量,以及$POSTGRESQL_HOST / $POSTGRES_HOST / $POSTGRESQL_USER / $HOST $POSTGRES_USER / $USER $POSTGRESQL_PASSWORD $ $POSTGRES_PASSWORD / $PASSWORD , $POSTGRESQL_DATABASE / $POSTGRES_DATABASE / $DATABASEpostgres_foreach_table.sh对每个表执行SQL查询,替换{db} , {schema}和{table}在每个迭代中。 select count(*) from {table}postgres_*.sh使用psql.sh进行行计数的各种脚本,迭代每个表或输出清洁数据库列表,图架和表格,用于快速脚本checks/check_sqlfluff.sh递归迭代给定或当前目录中发现的所有SQL代码文件,并运行SQLFluff Linter对它们,从每个路径/fileName/Extension推断出不同的SQL方言aws/目录:
aws_*.sh :aws_profile.sh切换为ARG给出的AWS配置文件,或提示用户使用方便的交互式菜单列表供AWS配置文件选择 - 当您有很多AWS工作配置文件时,很有用aws_cli_create_credential.sh使用管理权限(或其他组或策略)为CI/CD或CLI创建一个AWS服务帐户用户,创建AWS访问密钥,创建AWS访问密钥,保存凭据CSV,甚至保存shell Exports commants and aws cordenters cordentials cordentials文件配置以配置您的环境以开始使用它。有用的技巧避免CLI Reeuth每天aws sso login 。aws_terraform_create_credential.sh使用Terraform Cloud的管理员权限或其他CI/CD系统来创建一个AWS Terraform服务帐户,以运行Terraform Plan并应用Terraform计划,因为没有CI/CD Systems可以与AWS SSO工作流程一起使用。将访问密钥存储为CSV和打印Shell Export命令和凭据文件配置如上.envrc-aws .envrc.envrc-kubernetes设置隔离到当前外壳的kubectl上下文,以防止外壳和脚本之间的竞赛条件和脚本之间,而原本天真地更改全局~/.kube/config上下文aws_sso_ssh.sh将本地AWS SSO身份验证弹出窗口(如果尚未进行认证),然后SCP的最新结果~/.aws/sso/cache/ file到远程服务器和SSH在那里,以便您可以轻松地将AWS CLI或kubectl远程使用,而无需远程和远程copporter aws so coppory so coppory aws sosse sso soken aws soken aws soken aws,aws_terraform_create_s3_bucket.sh创建一个Terraform S3存储桶,用于存储后端状态,锁定公共访问,启用版本管理,加密和锁定电源用户的角色,并选择通过任何给定的用户/group/group/group Arns,以确保安全性ARN,以确保安全性ARN,以确保安全性ARNaws_terraform_create_dynamodb_table.sh在DynamoDB中创建一个供S3后端使用的Terraform锁定表,以及可以应用于较少特权帐户的自定义IAM策略aws_terraform_create_all.sh运行以上所有操作,另外还将自定义DynamoDB IAM策略应用于用户,以确保帐户是否较低,是否具有较低的特权,它仍然可以获取Terraform锁定(对于GitHub Actions Enivertry有用(对于GitHub Actions Enivertry secret secret secret of Read用户仅在不需要批准的情况下生成Terraform计划就可以生成Terraform计划,而无需批准)aws_terraform_iam_grant_s3_dynamodb.sh创建IAM策略以访问带有terraform-state或tf-state任何S3存储桶和DynamodB表中的名称,并将其附加到给定的用户。可用于有限的权限CI/CD帐户,该帐户运行Terraform计划。在github动作中拉请求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当您在给定阈值以上收费时,创建一个CloudWatch计费警报和SNS主题,以通过电子邮件发送给您。这通常是您要在帐户上做的第一件事aws_budget_alarm.sh在您开始产生预测的预测费用超过80%的预测费用和90%的实际用途时,创建一个AWS预算帐单帐单和SNS主题,并通过订阅给您发送电子邮件。这通常是您要在帐户上做的第一件事aws_batch_stale_jobs.sh列出了给定队列中N小时大于n小时的AWS批处理作业aws_batch_kill_stale_jobs.sh找到并杀死在给定队列中n小时大的AWS批处理作业aws_cloudfront_distribution_for_origin.sh返回分布的AWS CloudFront Arn,其中包含给定的子字符串。对于快速找到通过Cloudfront暴露的私人S3存储桶的权限所需的云端ARN很有用aws_cloudtrails_cloudwatch.sh列出云跟踪及其最后一次交付给CloudWatch日志(应该是最新的)aws_cloudtrails_event_selectors.sh列出云步道及其活动选择器以检查每个人至少具有一个事件选择器aws_cloudtrails_s3_accesslogging.sh列出了云跟踪存储桶及其访问记录前缀和目标存储桶。检查S3访问记录已启用aws_cloudtrails_s3_kms.sh列出云步道及其S3桶是否为KMSaws_cloudtrails_status.sh列出云跟踪状态 - 如果登录,多区域和日志文件验证aws_config_all_types.sh列表AWS配置记录器,检查所有资源类型(应为true),并包含全局资源(应为true)aws_config_recording.sh列表AWS配置记录器,其录制状态(应该是真实),其最后一个状态(应该是成功)aws_csv_creds.sh从CSV文件打印AWS凭据作为外壳导出语句。 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 )。支持新的用户和新访问密钥CSV文件格式。aws_codecommit_csv_creds.sh从CSV文件中打印AWS codeCommit git凭据作为外壳导出语句。类似的用例和链接如上aws_ec2_instance_name_to_id.sh从具有额外安全检查的实例名称中查找EC2实例ID,该名称仅返回一个实例ID,并且在该实例ID上进行反向查找以重新验证其匹配名称。如果传递实例ID,则将其返回,以便方便。相邻脚本使用aws_ec2_instances.sh列出AWS EC2实例,其DNS名称和状态易于读取表输出aws_ec2_terminate_instance_by_name.sh终止AWS EC2实例aws_ec2_create_ami_from_instance.sh从EC2实例中创建AWS EC2 AMI,并等待它可用于使用aws_ec2_clone_instance.sh通过从原始创建AMI,然后从AMI启动与原始实例相同的设置的新实例来启动新实例,从而克服AWS EC2实例。对于在单独的EC2实例上测试有风险的事情,例如服务器管理员的Tableau恢复aws_ec2_amis.sh列表AWS EC2 AMI属于您的帐户,易于阅读的表输出aws_ec2_ami_ids.sh列表AWS EC2 AMI ID,每行1个,用于在相邻脚本中使用,这些脚本创建映射表并将AMI ID转换为库存脚本中的名称aws_info_ec2*.shaws_ec2_ebs_*.sh -aws ec2 ebs脚本:aws_ec2_ebs_volumes.sh列表EC2实例及其EBS卷aws_ec2_ebs_volumes_unattached.sh列出表格格式的未连接的EBS卷aws_ecr_*.sh -aws ecr docker映像管理脚本:aws_ecr_docker_login.sh验证Docker到AWS ECR,从当前AWS帐户ID和区域推断ECR注册表aws_ecr_docker_build_push.sh构建Docker映像,并将其推向ECR,不仅使用latest Docker标签,还可以将当前的Git Hashref和Git标签推送到ECRaws_ecr_list_repos.sh列出ECR存储库及其Docker Image Mutability以及是否启用了图像扫描aws_ecr_list_tags.sh列出给定的ECR Docker映像的所有标签aws_ecr_newest_image_tags.sh列出具有latest创建日期的给定ecr docker映像的标签aws_ecr_alternate_tags.sh列出给定的ECR docker image:tag (使用arg <image>:latest查看哪个版本 / build hashRef / date标签已将标签标记为latest )aws_ecr_tag_image.sh标记ECR图像,带有另一个标签,而无需拉和推aws_ecr_tag_image_by_digest.sh与上述相同,但标记通过摘要找到的ECR图像(更准确地作为现有标签的参考可以是移动目标)。对于恢复已被标记的图像有用aws_ecr_tag_latest.sh标记给定的ECR docker image:tag为latest ,而无需拉或推动docker imageaws_ecr_tag_branch.sh标记给定的ECR image:tag而无需拉或推动docker imageaws_ecr_tag_datetime.sh标记给定的ECR Docker映像,其创建日期和UTC Timestamp(将其上传到ECR时)而无需拉或推动Docker Imageaws_ecr_tag_newest_image_as_latest.sh找到并标记给定的ECR Docker映像的latest构建,而无需拉或推动Docker Imageaws_ecr_tags_timestamps.sh列出给定的ECR docker图像的所有标签及其时间戳aws_ecr_tags_old.sh列出给定的ECR Docker图像的标签比N天大的标签aws_ecr_delete_old_tags.sh给定的ECR Docker映像的删除比N天大的标签。列出图像:要删除的标签并提示确认安全aws_foreach_profile.sh在AWS Cliv2中配置的所有名为profiles的AWS上执行模板命令,替换每次迭代中的{profile} 。与其他脚本结合使用,以实现强大功能,审核,设置等。例如。 aws_kube_creds.sh将在所有环境中配置kubectl配置aws_foreach_region.sh针对启用了频繁帐户的每个AWS区域执行模板命令,替换了每次迭代中的{region} 。与AWS CLI或脚本相结合以在各个地区找到资源aws_iam_*.sh -aws iam脚本:aws_iam_password_policy.sh打印aws密码策略在key = value对的值配对 / grepping( aws_harden_password_policy.sh使用之前和之后,以显示差异)aws_iam_harden_password_policy.sh根据CIS基础,加强AWS密码策略基础建议建议aws_iam_replace_access_key.sh替换非电流IAM访问密钥(不活跃,未使用,更长的时间,自所使用的时间或明确给定的键),输出新键作为shell Export语句(可用于管道上的aws_csv_creds.sh列出的同一工具)aws_iam_policies_attached_to_users.sh - finds AWS IAM policies directly attached to users (anti-best practice) instead of groupsaws_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 policiesaws_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 rolesaws_iam_generate_credentials_report_wait.sh - generates an AWS IAM credentials reportaws_iam_users.sh - list your IAM usersaws_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 dateaws_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 datesaws_iam_users_mfa_active_report.sh - lists AWS users password enabled and MFA enabled statusaws_iam_users_without_mfa.sh - lists AWS users with password enabled but no MFAaws_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 dateaws_ip_ranges.sh - get all AWS IP ranges for a given Region and/or Service using the IP range APIaws_info*.sh :aws_info_all_profiles.sh - calls aws_info.sh for all AWS profiles using aws_foreach_profile.shaws_info.sh - lists AWS deployed resources in the current or specified AWS account profileaws_info_ec2.sh - lists AWS EC2 Instances resources deployed in the current AWS accountaws_info_ec2_csv.sh - lists AWS EC2 Instances in quoted CSV format in the current AWS accountaws_info_ec2_all_profiles_csv.sh - lists AWS EC2 Instances in quoted CSV format across all configured AWS profiles for their configured regionaws_eks_cloudwatch_logs.sh - enables and fetches AWS EKS Master logs via CloudWatchaws_eks_ssh_dump_logs.sh - fetch system logs from EKS Worker Nodes EC2 VMs (eg. for support debug requests by vendors)aws_kms_key_rotation_enabled.sh - lists AWS KMS keys and whether they have key rotation enabledaws_kube_creds.sh - auto-loads all AWS EKS clusters credentials in the current --profile and --region so your kubectl is ready to rock on AWSaws_kubectl.sh - runs kubectl commands safely fixed to a given AWS EKS cluster using config isolation to avoid concurrency race conditionsaws_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 callersaws_logs_ec2_spot.sh - lists AWS EC2 Spot fleet creation requests, their caller and first tag value for origin hintaws_logs_ecs_tasks.sh - lists AWS ECS task run requests, their callers and job definitionsaws_meta.sh - AWS EC2 Metadata API query shortcut. See also the official ec2-metadata shell script with more featuresaws_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 callsaws_rds_list.sh - list RDS instances with select fields - Name, Status, Engine, AZ, Instance Type, Storageaws_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 addressaws_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 connectionsaws_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 configurationaws_sso_accounts.sh - lists all AWS SSO accounts the current SSO user has access toaws_sso_configs.sh - generates AWS SSO configs for all AWS SSO accounts the currently logged in SSO user has access toaws_sso_configs_save.sh - saves AWS SSO configs generated by aws_sso_configs.sh to ~/.aws/config if they're not already foundaws_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.shaws_sso_config_duplicate_profile_names.sh - lists duplicate AWS SSO config profile names that are using the same sso_account_idaws_sso_env_creds.sh - retrieves AWS SSO session credentials in the format of environment export commands for copying to other systems like Terraform Cloudaws_sso_role_arn.sh - prints the currently authenticated AWS SSO user's role ARN in IAM policy usable formataws_sso_role_arns.sh - prints all AWS SSO role ARNs in IAM policy usable formataws_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 foundaws_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 direnvsaws_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 lineaws_s3_account_block_public_access.sh - blocks S3 public access at the AWS account levelaws_s3_check_buckets_public_blocked.sh - iterates each S3 bucket and checks it has public access fully blocked via policy. Parallelized for speedupaws_s3_check_account_public_blocked.sh - checks S3 public access is blocked at the AWS account levelaws_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 pathsaws_s3_access_logging.sh - lists AWS S3 buckets and their access logging statusaws_s3_delete_bucket_with_versions.sh - deletes a bucket including all versions.谨慎使用!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 bootaws_sqs_check.sh - sends a test message to an AWS SQS queue, retrieves it to check and then deletes it via the receipt handle idaws_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 screenaws_secret*.sh - AWS Secrets Manager scripts:aws_secret_list.sh - returns the list of secrets, one per lineaws_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 screenaws_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 accountsaws_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 screenaws_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 accountaws_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 availableeksctl_cluster.sh - downloads eksctl and creates an AWS EKS Kubernetes clusterSee also Knowledge Base notes for AWS.
gcp/ directory:
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.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 contextgcp_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 projectsgcp_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 itgcp_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 itgcp_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 indexesgcp_info_cloud_sql.sh - Cloud SQL instances, whether their backups are enabled, and all databases on each instancegcp_info_cloud_sql_databases.sh - lists databases inside each Cloud SQL instance. Included in gcp_info_cloud_sql.shgcp_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 GCSgcp_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 usersgcp_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 domainsgcp_info_bigdata.sh - Dataproc clusters and jobs in all regions, Dataflow jobs in all regions, PubSub messaging topics, Cloud IOT registries in all regionsgcp_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 deploymentsgcp_info_auth_config.sh - Auth Configurations, Organizations & Current Configgcp_info_projects.sh - Projects names and IDsgcp_info_services.sh - Services & APIs enabledgcp_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 servicesgcp_info_accounts_secrets.sh - IAM Service Accounts, Secret Manager secretsgcp_info_all_projects.sh - same as above but for all detected projectsgcp_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 screengcp_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 accountsgcp_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 screengcp_secret_get.sh - finds the latest version of a given GCP Secret Manager secret and returns its value. Used by adjacent scriptsgcp_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.shgcp_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 repogcp_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 repogcp_secrets_labels.sh - lists GCP Secrets and their labels, one per line suitable for quick views or shell pipelinesgcp_secrets_update_lable.sh - updates all GCP secrets in current project matching label key=value with a new label valuegcp_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 scriptsgke_kube_creds.sh - auto-loads all GKE clusters credentials in the current / given / all projects so your kubectl is ready to rock on GCPgke_kubectl.sh - runs kubectl commands safely fixed to a given GKE cluster using config isolation to avoid concurrency race conditionsgke_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 imagegcr_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 imagegcr_tag_branch.sh - tags a given GCR docker image:tag with the current Git branch without pulling or pushing the docker imagegcr_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 imagegcr_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 imagegcr_tags_timestamps.sh - lists all the tags and their timestamps for a given GCR docker imagegcr_tags_old.sh - lists tags older than N days for a given GCR docker imagegcr_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 safetygcp_ci_build.sh - script template for CI/CD to trigger Google Cloud Build to build docker container image with extra datetime and latest tagginggcp_ci_deploy_k8s.sh - script template for CI/CD to deploy GCR docker image to GKE Kubernetes using Kustomizegce_*.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 projectgce_host_ips.sh - prints the IPs and hostnames of all or a regex match of GCE VMs for use in /etc/hostsgce_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 VMsgcs_ssh_keyscan.sh - SSH keyscans all the GCE VMs returned from the above gce_host_ips.sh script and adds them to ~/.ssh/known_hostsgce_meta.sh - simple script to query the GCE metadata API from within Virtual Machinesgce_when_preempted.sh - GCE VM preemption latch script - can be executed any time to set one or more commands to execute upon preemptiongce_is_preempted.sh - GCE VM return true/false if preempted, callable from other scriptsgce_instance_service_accounts.sh - lists GCE VM instance names and their service accountsgcp_firewall_disable_default_rules.sh - disables those lax GCP default network "allow all" firewall rulesgcp_firewall_risky_rules.sh - lists risky GCP firewall rules that are enabled and allow traffic from 0.0.0.0/0gcp_sql_*.sh - Cloud SQL scripts:gcp_sql_backup.sh - creates Cloud SQL backupsgcp_sql_export.sh - creates Cloud SQL exports to GCSgcp_sql_enable_automated_backups.sh - enable automated daily Cloud SQL backupsgcp_sql_enable_point_in_time_recovery.sh - enable point-in-time recovery with write-ahead logsgcp_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 necessarygcp_sql_running_primaries.sh - lists primary running Cloud SQL instancesgcp_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 GCSgcp_sql_grant_instances_gcs_object_creator.sh - grants minimal GCS objectCreator permission on a bucket to primary Cloud SQL instances for exportsgcp_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 projectbigquery_*.sh - BigQuery scripts:bigquery_list_datasets.sh - lists BigQuery datasets in the current GCP projectbigquery_list_tables.sh - lists BigQuery tables in a given datasetbigquery_list_tables_all_datasets.sh - lists tables for all datasets in the current GCP projectbigquery_foreach_dataset.sh - executes a templated command for each datasetbigquery_foreach_table.sh - executes a templated command for each table in a given datasetbigquery_foreach_table_all_datasets.sh - executes a templated command for each table in each dataset in the current GCP projectbigquery_table_row_count.sh - gets the row count for a given tablebigquery_tables_row_counts.sh - gets the row counts for all tables in a given datasetbigquery_tables_row_counts_all_datasets.sh - gets the row counts for all tables in all datasets in the current GCP projectbigquery_generate_query_biggest_tables_across_datasets_by_row_count.sh - generates a BigQuery SQL query to find the top 10 biggest tables by row countbigquery_generate_query_biggest_tables_across_datasets_by_size.sh - generates a BigQuery SQL query to find the top 10 biggest tables by sizegcp_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 keysgcp_service_accounts_credential_keys_age.sh - lists all service account credential keys age in daysgcp_service_accounts_credential_keys_expired.sh - lists expired service account credential keys that should be removed and recreated if neededgcp_service_account_members.sh - lists all members and roles authorized to use any service accounts. Useful for finding GKE Workload Identity mappingsgcp_iam_*.sh :gcp_iam_roles_in_use.sh - lists GCP IAM roles in use in the current or all projectsgcp_iam_identities_in_use.sh - lists GCP IAM identities (users/groups/serviceAccounts) in use in the current or all projectsgcp_iam_roles_granted_to_identity.sh - lists GCP IAM roles granted to identities matching the regex (users/groups/serviceAccounts) in the current or all projectsgcp_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 projectsgcp_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 managementgcp_iam_serviceaccount_members.sh - lists members with permissions to use each GCP service accountgcp_iam_serviceaccounts_without_permissions.sh - finds service accounts without IAM permissionns, useful to detect obsolete service accounts after a 90 day unused permissions clean outgcp_iam_workload_identities.sh - lists GKE Workload Identity integrations, uses gcp_iam_serviceaccount_members.shgcp_iam_users_granted_directly.sh - lists GCP IAM users which have been granted roles directly in violation of best-practice group-based managementgcs_bucket_project.sh - finds the GCP project that a given bucket belongs to using the GCP Storage APIgcs_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 scriptsSee 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 contextaws/eksctl_cluster.sh - quickly spins up an AWS EKS cluster using eksctl with some sensible defaultskubernetes_info.sh - huge Kubernetes inventory listing of deployed resources across all namespaces in the current cluster / kube context:kubectl.sh - runs kubectl commands safely fixed to a given context using config isolation to avoid concurrency race conditionskubectl_diff_apply.sh - generates a kubectl diff and prompts to applykustomize_diff_apply.sh - runs Kustomize build, precreates any namespaces, shows a kubectl diff of the proposed changes, and prompts to applykustomize_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 baseskubectl_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 safetykubernetes_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 objectskustomize_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 labelskubectl_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 typeskubectl_get_annotation.sh - find a type of object with a given annotationkubectl_restart.sh - restarts all or filtered deployments/statefulsets in the current or given namespace. Useful when debugging or clearing application problemskubectl_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 testingkubectl_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.shkubectl_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 Secretskubernetes_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 themkubernetes_secret_to_external_secret.sh - generates an External Secret from an existing Kubernetes secretkubernetes_secrets_to_external_secrets.sh - generates External Secrets from all existing Kubernetes secrets found in the current or given namespacekubernetes_secret_to_sealed_secret.sh - generates a Bitnami Sealed Secret from an existing Kubernetes secretkubernetes_secrets_to_sealed_secrets.sh - generates Bitnami Sealed Secrets from all existing Kubernetes secrets found in the current or given namespacekubectl_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 ownerReferenceskubectl_secrets_to_be_sealed.sh - finds secrets pending overwrite by Sealed Secrets with the managed annotationkubernetes_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 iterationkubernetes_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 headerkubernetes_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 repokubernetes_etcd_backup.sh - creates a timestamped backup of the Kubernetes Etcd database for a kubeadm clusterkubernetes_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 deletionkubeadm_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 clusterkubernetes_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 claritykubectl_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 claritykubectl_pods_per_node.sh - lists number of pods per node sorted descendingkubectl_pods_important.sh - lists important pods and their nodes to check on schedulingkubectl_pods_colocated.sh - lists pods from deployments/statefulsets that are colocated on the same nodekubectl_node_labels.sh - lists nodes and their labels, one per line, easier to read visually or pipe in scriptingkubectl_pods_running_with_labels.sh - lists running pods with labels matching key=value pair argumentskubectl_node_taints.sh - lists nodes and their taintskubectl_jobs_stuck.sh - finds Kubernetes jobs stuck for hours or days with no completionskubectl_jobs_delete_stuck.sh - prompts for confirmation to delete stuck Kubernetes jobs found by script abovekubectl_images.sh - lists Kubernetes container images running on the current clusterkubectl_image_counts.sh - lists Kubernetes container images running counts sorted descendingkubectl_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.iokubectl_pod_count.sh - lists Kubernetes pods total running countkubectl_pod_labels.sh - lists Kubernetes pods and their labels, one label per line for easier shell script piping for further actionskubectl_pod_ips.sh - lists Kubernetes pods and their pod IP addresseskubectl_container_count.sh - lists Kubernetes containers total running countkubectl_container_counts.sh - lists Kubernetes containers running counts by name sorted descendingkubectl_pods_dump_*.sh - dump stats / logs / jstacks from all pods matching a given regex and namespace to txt files for support debuggingkubectl_pods_dump_stats.sh - dump statskubectl_pods_dump_logs.sh - dump logskubectl_pods_dump_jstacks.sh - dump Java jstackskubectl_pods_dump_all.sh - calls the above kubectl_pods_dump_*.sh scripts for N iterations with a given intervalkubectl_empty_namespaces.sh - finds namespaces without any of the usual objects using kubectl get allkubectl_delete_empty_namespaces.sh - removes empty namespaces, uses kubectl_empty_namespaces.shkubectl_<image>.sh - quick launch one-off pods for interactive debuggging in Kuberneteskubectl_alpine.shkubectl_busybox.shkubectl_curl.shkubectl_dnsutils.shkubectl_gcloud_sdk.shkubectl_run_sa.sh - launch a quick pod with the given service account to test private repo pull & other permissionskubectl_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 browserkubectl_port_forward_spark.sh - does the above for Spark UIhelm_template.sh - templates a Helm chart for Kustomize deploymentskustomize_parse_helm_charts.sh - parses the Helm charts from one or more kustomization.yaml files into TSV format for further shell pipe processingkustomize_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 containkustomize_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 performanceargocd_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 appargocd_apps_sync.sh - sync's all ArgoCD apps matching an optional ERE regex filter on their names using the ArgoCD CLIargocd_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 operationargocd_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 Podspluto_detect_helm_materialize.sh - recursively materializes all helm Chart.yaml and runs Pluto on each directory to work around this issuepluto_detect_kustomize_materialize.sh - recursively materializes all kustomization.yaml and runs Pluto on each directory to work around this issuepluto_detect_kubectl_dump_objects.sh - dumps all live Kubernetes objects to /tmp all can run Pluto to detect deprecated API objects on the cluster from any sourcerancher_api.sh - queries the Rancher API with authenticationrancher_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 rockSee 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 setdocker_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 contentsdocker_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 versionsdocker_registry_list_images.sh - lists images in a given private Docker Registrydocker_registry_list_tags.sh - lists tags for a given image in a private Docker Registrydocker_registry_get_image_manifest.sh - gets a given image:tag manifest from a private Docker Registrydocker_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 descendingdockerhub_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 sizequay_api.sh - queries the Quay.io API with OAuth2 authentication token $QUAY_TOKENSee 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
wordcount.sh - counts and ranks words by their frequency in file(s) or stdin
Data format validation validate_*.py from DevOps Python Tools repo:
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 connectzookeeper_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 connecthive_*.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 pipelineshive_list_tables.sh - list Hive tables, one per line, suitable for scripting pipelineshive_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 tablehive_tables_column_counts.sh - lists the column count per Hive tableimpala*.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 pipelinesimpala_list_tables.sh - list Impala tables, one per line, suitable for scripting pipelinesimpala_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 tableimpala_tables_column_counts.sh - lists the column count per Impala tablehdfs_*.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 timehdfs_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 sizehadoop_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 nodescloudera_*.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.shcloudera_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.shcloudera_manager_yarn_apps.sh - queries Cloudera Manager for recent Yarn apps. Built on top of cloudera_manager_api.shcloudera_navigator_api.sh - script to simplify querying Cloudera Navigator API using environment variables, prompts, authentication and sensible defaults. Built on top of curl_auth.shcloudera_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.shcloudera_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.shSee 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 passgit_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 hotkeysgit_review_push.sh - shows diff of what would be pushed upstream and prompts to push. Convenient for fast reviewed pushes via vim or IDEs hotkeysgit_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 givengit_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 statusgit_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 easilygit_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 updatinggit_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 commandgit_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 setgit_repos_pull.sh - pull multiple repos based on a source file mapping list - useful for easily sync'ing lots of Git repos among computersgit_repos_update.sh - same as above but also runs the make update build to install the latest dependencies, leverages the above scriptgit_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_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 checkoutgit_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 checkoutgit_graph_commit_times_gnuplot.sh - generates a GNUplot graph of Git commit times from the current Git repo checkout's git loggit_graph_commit_times_mermaidjs.sh - generates a MermaidJS graph of Git commit times from the current Git repo checkout's git loggit_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 checkoutgit_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 checkoutgit_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 changegit_files_in_history.sh - finds all filename / file paths in the git log history, useful for prepping for git filter-branchgit_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 Expertsgit_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 safetygit_submodules_update_repos.sh - updates submodules (pulls and commits latest upstream github repo submodules) - used to cascade submodule updates throughout all my reposgit_askpass.sh - credential helper script to use environment variables for git authenticationmarkdown_generate_index.sh - generates a markdown index list from the headings in a given markdown file such as README.mdmarkdown_replace_index.sh - replaces a markdown index section in a given markdown file using markdown_generate_index.shgithub/*.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 filesgithub_foreach_repo.sh - executes a templated command for each non-fork GitHub repo, replacing the {owner} / {name} or {repo} placeholders in each iterationgithub_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 APIgithub_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 APIgithub_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 directorygithub_download_release_file.sh - downloads a file from GitHub Releases, optionally determining the latest version, uses bin/download_url_file.shgithub_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 formatgithub_invitations.sh - lists / accepts repo invitations. Useful to accept a large number of invites to repos generated by automationgithub_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/releasesgithub_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/releasesgithub_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/releasesgithub_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/releasesgithub_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 prefixgithub_pull_request_preview.sh - opens a GitHub Pull Request preview page from the current local branch to the given or default branchgithub_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 browsergithub_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 reviewgithub_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 developgithub_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 repogithub_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 Requestsgithub_forked_add_remote.sh - quickly adds a forked repo as a remote from an interactive men list of forked reposgithub_forked_checkout_branch.sh - quickly check out a forked repo's branch from an interactive menu lists of forked repos and their branchesgithub_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 Practicesgithub_actions_foreach_workflow.sh - executes a templated command for each workflow in a given GitHub repo, replacing {name} , {id} and {state} in each iterationgithub_actions_aws_create_load_credential.sh - creates an AWS user with group/policy, generates and downloads access keys, and uploads them to the given repogithub_actions_in_use.sh - lists GitHub Actions directly referenced in the .github/workflows in the current local repo checkoutgithub_actions_in_use_repo.sh - lists GitHub Actions for a given repo via the API, including following imported reusable workflowsgithub_actions_in_use_across_repos.sh - lists GitHub Actions in use across all your reposgithub_actions_repos_lockdown.sh - secures GitHub Actions settings across all user repos to only GitHub, verified partners and selected 3rd party actionsgithub_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 auditinggithub_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 repogithub_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 configurationgithub_actions_runner_local.sh - downloads, configures and runs a local GitHub Actions Runner for Linux or Macgithub_actions_runner_token.sh - generates a GitHub Actions runner token to register a new self-hosted runnergithub_actions_runners.sh - lists GitHub Actions self-hosted runners for a given Repo or Organizationgithub_actions_delete_offline_runners.sh - deletes offline GitHub Actions self-hosted runners. Useful to clean up short-lived runners eg. Docker, Kubernetesgithub_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 namegithub_actions_workflows_status.sh - lists all GitHub Actions workflows and their statuses for a given repogithub_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 workflowsgithub_actions_workflow_enable.sh - enables a given GitHub Actions workflowgithub_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 commitgithub_actions_workflows_trigger_all.sh - triggers all workflows for the given repogithub_actions_workflows_cancel_all_runs.sh - cancels all workflow runs for the given repogithub_actions_workflows_cancel_waiting_runs.sh - cancels workflow runs that are in waiting state, eg. waiting for old deployment approvalsgithub_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 toolsgithub_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 commentsgithub_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 toolsgithub_ssh_delete_public_keys.sh - deletes given SSH keys from the currently authenticated GitHub account by key id or title regex matchgithub_gpg_get_user_public_keys.sh - fetches a given GitHub user's public GPG keys via the APIgithub_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 pagegithub_ip_ranges.sh - returns GitHub's IP ranges, either all by default or for a select given service such as hooks or actionsgithub_sync_repo_descriptions.sh - syncs GitHub repo descriptions to GitLab & BitBucket reposgithub_release.sh - creates a GitHub Release, auto-incrementing a .N suffix on the year/month/day date format if no exact version givengithub_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 ArgoCDgithub_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 APIgithub_repo_latest_release.sh - returns the latest release tag for a given GitHub repo via the GitHub APIgithub_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 kyamlgithub_repo_stars.sh - fetches the stars, forks and watcher counts for a given repogithub_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 reposgithub_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 reposgithub_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 , productiongithub_repos_find_files.sh - finds files matching a regex across all repos in the current GitHub organization or user accountgithub_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 auditabilitygithub_repo_fork_update.sh - updates a forked repo by creating pull requests for full audit tracking and auto-merges PRs for non-production branchesgithub_repos_public.sh - lists public repos for a user or organization. Useful to periodically scan and account for any public reposgithub_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 Slitegithub_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 privilegesgithub_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 privilegesgithub_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 codegithub_teams_not_in_terraform.sh - finds all teams for given organization which are not found in $PWD/*.tf Terraform codegithub_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 hashrefsgithub_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 removedgithub_user_repos_stars.sh - fetches the total number of stars for all original source public repos for a given usergithub_user_repos_forks.sh - fetches the total number of forks for all original source public repos for a given usergithub_user_repos_count.sh - fetches the total number of original source public repos for a given usernamegithub_user_followers.sh - fetches the number of followers for a given usernamegithub_url_clipboard.sh - copies a GitHub URL file's contents to the clipboard, converting the URL to a raw GitHub content URL where necessarygitlab/*.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 filesgitlab_push_mr_preview.sh - pushes to GitLab origin, sets upstream branch, then open a Merge Request preview from current to default branchgithub_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 reviewgitlab_foreach_repo.sh - executes a templated command for each GitLab project/repo, replacing the {user} and {project} in each iterationgitlab_project_latest_release.sh - returns the latest release tag for a given GitLab project (repo) via the GitLab APIgitlab_project_set_description.sh - sets the description for one or more projects using the GitLab APIgitlab_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 , productiongitlab_project_mirrors.sh - lists each GitLab repo and whether it is a mirror or notgitlab_pull_mirror.sh - trigger a GitLab pull mirroring for a given project's repo, or auto-infers project name from the local git repogitlab_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 toolsgitlab_ssh_get_public_keys.sh - fetches the currently authenticated GitLab user's public SSH keys via the APIgitlab_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 toolsgitlab_ssh_delete_public_keys.sh - deletes given SSH keys from the currently authenticated GitLab account by key id or title regex matchgitlab_validate_ci_yaml.sh - validates a .gitlab-ci.yml file via the GitLab APIbitbucket/*.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 iterationbitbucket_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 APIbitbucket_enable_pipelines.sh - enables the CI/CD pipelines for all reposbitbucket_disable_pipelines.sh - disables the CI/CD pipelines for all reposbitbucket_repo_enable_pipeline.sh - enables the CI/CD pipeline for a given repobitbucket_repo_disable_pipeline.sh - disables the CI/CD pipeline for a given repobitbucket_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 toolsbitbucket_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 toolsbitbucket_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 toolsSee also Knowledge Base notes for Git.
jenkins/ , terraform/ , teamcity/ , buildkite/ , circlci/ , travis/ , azure_devops/ , ..., cicd/ directories:
appveyor_api.sh - queries AppVeyor's API with authenticationazure_devops/*.sh - Azure DevOps scripts:azure_devops_api.sh - queries Azure DevOps's API with authenticationazure_devops_foreach_repo.sh - executes a templated command for each Azure DevOps repo, replacing {user} , {org} , {project} and {repo} in each iterationazure_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 behaviourazure_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 authenticationcircleci_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 APIcircleci_context_delete_env_vars.sh - deletes CircleCI context-level environment variable(s) via the APIcircleci_local_execute.sh - installs CircleCI CLI and executes .circleci/config.yml locallycircleci_public_ips.sh - lists CircleCI public IP addresses via dnsjson.comcodeship_api.sh - queries CodeShip's API with authenticationdrone_api.sh - queries Drone.io's API with authenticationshippable_api.sh - queries Shippable's API with authenticationwercker_app_api.sh - queries Wercker's Applications API with authenticationgocd_api.sh - queries GoCD's APIgocd.sh - one-touch GoCD CI:$PWD/setup/gocd_config_repo.json ) from which to source pipeline(s) ( .gocd.yml ).gocd.yml config (all mine have it), mimicking structure of fully managed CI systemsconcourse.sh - one-touch Concourse CI:$PWD/.concourse.yml.concourse.yml config (all mine have it), mimicking structure of fully managed CI systemsfly.sh - shortens Concourse fly command to not have to specify target all the timejenkins/*.sh - Jenkins CI scripts:jenkins.sh - one-touch Jenkins CI:Jenkinsfile$PWD/setup/jenkins-job.xmlJenkinsfileJenkinsfile 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 usejenkins_jobs.sh - lists Jenkins jobs (pipelines)jenkins_foreach_job.sh - runs a templated command for each Jenkins jobjenkins_jobs_download_configs.sh - downloads all Jenkins job configs to xml files of the same namejenkins_job_config.sh - gets or sets a Jenkins job's configjenkins_job_description.sh - gets or sets a Jenkins job's descriptionjenkins_job_enable.sh - enables a Jenkins job by namejenkins_job_disable.sh - disables a Jenkins job by namejenkins_job_trigger.sh - triggers a Jenkins job by namejenkins_job_trigger_with_params.sh - triggers a Jenkins job with parameters which can be passed as --data KEY=VALUEjenkins_jobs_enable.sh - enables all Jenkins jobs/pipelines with names matching a given regexjenkins_jobs_disable.sh - disables all Jenkins jobs/pipelines with names matching a given regexjenkins_builds.sh - lists Jenkins latest builds for every jobjenkins_cred_add_cert.sh - creates a Jenkins certificate credential from a PKCS#12 keystorejenkins_cred_add_kubernetes_sa.sh - creates a Jenkins Kubernetes service account credentialjenkins_cred_add_secret_file.sh - creates a Jenkins secret file credential from a filejenkins_cred_add_secret_text.sh - creates a Jenkins secret string credential from a string or a filejenkins_cred_add_ssh_key.sh - creates a Jenkins SSH key credential from a string or an SSH private key filejenkins_cred_add_user_pass.sh - creates a Jenkins username/password credentialjenkins_cred_delete.sh - deletes a given Jenkins credential by idjenkins_cred_list.sh - lists Jenkins credentials IDs and Namesjenkins_cred_update_cert.sh - updates a Jenkins certificate credential from a PKCS#12 keystorejenkins_cred_update_kubernetes_sa.sh - updates a Jenkins Kubernetes service account credentialjenkins_cred_update_secret_file.sh - updates a Jenkins secret file credential from a filejenkins_cred_update_secret_text.sh - updates a Jenkins secret string credential from a string or a filejenkins_cred_update_ssh_key.sh - updates a Jenkins SSH key credential from a string or an SSH private key filejenkins_cred_update_user_pass.sh - updates a Jenkins username/password credentialjenkins_cred_set_cert.sh - creates or updates a Jenkins certificate credential from a PKCS#12 keystorejenkins_cred_set_kubernetes_sa.sh - creates or updates a Jenkins Kubernetes service account credentialjenkins_cred_set_secret_file.sh - creates or updates a Jenkins secret file credential from a filejenkins_cred_set_secret_text.sh - creates or updates a Jenkins secret string credential from a string or a filejenkins_cred_set_ssh_key.sh - creates or updates a Jenkins SSH key credential from a string or an SSH private key filejenkins_cred_set_user_pass.sh - creates or updates a Jenkins username/password credentialjenkins_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 容器。 Used heavily by jenkins.sh one-shot setup and the following scripts:jenkins_foreach_job_cli.sh - runs a templated command for each Jenkins jobjenkins_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 agentsjenkins_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 integrationjenkins_jobs_download_configs_cli.sh - downloads all Jenkins job configs to xml files of the same namejenkins_cred_cli_add_cert.sh - creates a Jenkins certificate credential from a PKCS#12 keystorejenkins_cred_cli_add_kubernetes_sa.sh - creates a Jenkins Kubernetes service account credentialjenkins_cred_cli_add_secret_file.sh - creates a Jenkins secret file credential from a filejenkins_cred_cli_add_secret_text.sh - creates a Jenkins secret string credential from a string or a filejenkins_cred_cli_add_ssh_key.sh - creates a Jenkins SSH key credential from a string or an SSH private key filejenkins_cred_cli_add_user_pass.sh - creates a Jenkins username/password credentialjenkins_cred_cli_delete.sh - deletes a given Jenkins credential by idjenkins_cred_cli_list.sh - lists Jenkins credentials IDs and Namesjenkins_cred_cli_update_cert.sh - updates a Jenkins certificate credential from a PKCS#12 keystorejenkins_cred_cli_update_kubernetes_sa.sh - updates a Jenkins Kubernetes service account credentialjenkins_cred_cli_update_secret_file.sh - updates a Jenkins secret file credential from a filejenkins_cred_cli_update_secret_text.sh - updates a Jenkins secret string credential from a string or a filejenkins_cred_cli_update_ssh_key.sh - updates a Jenkins SSH key credential from a string or an SSH private key filejenkins_cred_cli_update_user_pass.sh - updates a Jenkins username/password credentialjenkins_cred_cli_set_cert.sh - creates or updates a Jenkins certificate credential from a PKCS#12 keystorejenkins_cred_cli_set_kubernetes_sa.sh - creates or updates a Jenkins Kubernetes service account credentialjenkins_cred_cli_set_secret_file.sh - creates or updates a Jenkins secret file credential from a filejenkins_cred_cli_set_secret_text.sh - creates or updates a Jenkins secret string credential from a string or a filejenkins_cred_cli_set_ssh_key.sh - creates or updates a Jenkins SSH key credential from a string or an SSH private key filejenkins_cred_cli_set_user_pass.sh - creates or updates a Jenkins username/password credentialjenkins_password.sh - gets Jenkins admin password from local docker container. Used by jenkins_cli.shjenkins_plugins_latest_versions.sh - finds the latest versions of given Jenkins plugins. Useful to programmatically upgrade your Jenkins on Kubernetes plugins defined in values.yamlcheck_jenkinsfiles.sh - validates all *Jenkinsfile* files in the given directory trees using the online Jenkins validatorteamcity/*.sh - TeamCity CI scripts:teamcity.sh - one-touch TeamCity CI cluster:$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 variablesteamcity_api.sh - queries TeamCity's API, auto-handling authentication and other quirks of the APIteamcity_create_project.sh - creates a TeamCity project using the APIteamcity_create_github_oauth_connection.sh - creates a TeamCity GitHub OAuth VCS connection in the Root project, useful for bootstrapping projects from VCS configsteamcity_create_vcs_root.sh - creates a TeamCity VCS root from a save configuration (XML or JSON), as downloaded by teamcity_export_vcs_roots.shteamcity_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 dateteamcity_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 IDsteamcity_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 descriptionteamcity_buildtypes_set_description_from_github.sh - sync's all TeamCity buildType descriptions from their GitHub repos where availableteamcity_export.sh - downloads TeamCity configs to local JSON files in per-project directories mimicking native TeamCity directory structure and file namingteamcity_export_project_config.sh - downloads TeamCity project config to local JSON filesteamcity_export_buildtypes.sh - downloads TeamCity buildType config to local JSON filesteamcity_export_vcs_roots.sh - downloads TeamCity VCS root config to local JSON filesteamcity_projects.sh - lists TeamCity project IDs and Namesteamcity_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 Namestravis/*.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_TOKENtravis_repos.sh - lists Travis CI repostravis_foreach_repo.sh - executes a templated command against all Travis CI repostravis_repo_build.sh - triggers a build for the given repotravis_repo_caches.sh - lists caches for a given repotravis_repo_crons.sh - lists crons for a given repotravis_repo_env_vars.sh - lists environment variables for a given repotravis_repo_settings.sh - lists settings for a given repotravis_repo_create_cron.sh - creates a cron for a given repo and branchtravis_repo_delete_crons.sh - deletes all crons for a given repotravis_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 IDtravis_repos_settings.sh - lists settings for all repostravis_repos_caches.sh - lists caches for all repostravis_repos_crons.sh - lists crons for all repostravis_repos_create_cron.sh - creates a cron for all repostravis_repos_delete_crons.sh - deletes all crons for all repostravis_repos_delete_caches.sh - deletes all caches for all repostravis_lint.sh - lints a given .travis.yml using the APIbuildkite/*.sh - BuildKite API scripts:buildkite_api.sh - queries the BuildKite API, handling authentication using $BUILDKITE_TOKENbuildkite_pipelines.sh - list buildkite pipelines for your $BUILDKITE_ORGANIZATION / $BUILDKITE_USERbuildkite_foreach_pipeline.sh - executes a templated command for each Buildkite pipeline, replacing the {user} and {pipeline} in each iterationbuildkite_agent.sh - runs a buildkite agent locally on Linux or Mac, or in Docker with choice of Linux distrosbuildkite_agents.sh - lists the Buildkite agents connected along with their hostname, IP, started dated and agent detailsbuildkite_pipelines.sh - lists Buildkite pipelinesbuildkite_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 formatbuildkite_update_pipeline.sh - updates a BuildKite pipeline from a configuration provided via stdin or from a file saved via buildkite_get_pipeline.shbuildkite_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.shbuildkite_pipeline_skip_settings.sh - lists the skip intermediate build settings for one or more given BuildKite pipelinesbuildkite_pipeline_set_skip_settings.sh - configures given or all BuildKite pipelines to skip intermediate builds and cancel running builds in favour of latest buildbuildkite_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 vulnerabilitiesbuildkite_pipelines_vulnerable_forked_pull_requests.sh - prints the status of each pipeline, should all return false, otherwise run the above script to close the vulnerabilitybuildkite_rebuild_cancelled_builds.sh - triggers rebuilds of last N cancelled builds in current pipelinebuildkite_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 organizationbuildkite_rebuild_all_pipelines_last_failed.sh - triggers rebuilds of the last failed build in each pipeline in the organizationbuildkite_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 buildbuildkite_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 onbuildkite_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 APIbuildkite_set_pipeline_description_from_github.sh - sets a Buildkite pipeline description to match its source GitHub repobuildkite_sync_pipeline_descriptions_from_github.sh - for all BuildKite pipelines sets each description to match its source GitHub repobuildkite_trigger.sh - triggers BuildKite build job for a given pipelinebuildkite_trigger_all.sh - same as above but for all pipelinesterraform_cloud_*.sh - Terraform Cloud API scripts:terraform_cloud_api.sh - queries the Cloudflare API, handling authentication using $TERRAFORM_TOKENterraform_cloud_ip_ranges.sh - returns the list of IP ranges for Terraform Cloudterraform_cloud_organizations.sh - lists Terraform Cloud organizationsterraform_cloud_workspaces.sh - lists Terraform Cloud workspacesterraform_cloud_workspace_vars.sh - lists Terraform Cloud workspace variablesterraform_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 variablesterraform_cloud_varsets.sh - lists Terraform Cloud variable setsterraform_cloud_varset_vars.sh - lists Terraform Cloud variables in on or all variables sets for the given organizationterraform_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 setterraform_*.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.tfterraform_gitlab_download_backend_variable.sh - downloads backend.tf from a GitLab CI/CD variable to be able to quickly iterate plans locallyterraform_import.sh - finds given resource type in ./*.tf code or Terraform plan output that are not in Terraform state and imports themterraform_import_aws_iam_users.sh - parses Terraform plan output to import new aws_iam_user additions into Terraform stateterraform_import_aws_iam_groups.sh - parses Terraform plan output to import new aws_iam_group additions into Terraform stateterraform_import_aws_iam_policies.sh - parses Terraform plan output to import new aws_iam_policies additions, resolves their ARNs and imports them into Terraform stateterraform_import_aws_sso_permission_sets.sh - finds all aws_ssoadmin_permission_set in ./*.tf code, resolves the ARNs and imports them to Terraform stateterraform_import_aws_sso_account_assignments.sh - parses Terraform plan output to import new aws_ssoadmin_account_assignment additions into Terraform stateterraform_import_aws_sso_managed_policy_attachments.sh - parses Terraform plan output to import new aws_ssoadmin_account_assignment additions into Terraform stateterraform_import_aws_sso_permission_set_inline_policies.sh - parses Terraform plan output to import new aws_ssoadmin_permission_set_inline_policy additions into Terraform stateterraform_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.shterraform_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 Terraformterraform_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.shterraform_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 stateterraform_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 managingterraform_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 aboveterraform_registry_url_to_https.sh - converts one or more Terraform Registry URLs from tfr:// to https://registry.terraform.io/ formatterraform_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/ formatcheckov_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 directorycheckov_resource_count_all.sh - counts the total number of resources Checkov is scanning across all given repo checkoutsoctopus_api.sh - queries the Octopus Deploy APISee also Knowledge Base notes for CI/CD.
ai/ and ipaas/ directories:
openai_api.sh - queries the OpenAI (ChatGPT) API with authenticationmake_api.sh - queries the Make.com API with authenticationinternet/ , cloudflare/ , pingdom/ , terraform/ directories:
pastebin.sh - uploads a file to https://pastebin.com, script auto-determines which syntax highlighting to add since API doesn't auto inferdpaste.sh - uploads a file to https://dpaste.com, script auto-determines which syntax highlighting to add since API doesn't auto infertermbin.sh - uploads a file to https://termbin.com (site has no syntax highlighting)0x0.sh - uploads a file to https://0x0.st (fast)imgur.sh - uploads an image file to https://imgur.comfile.io.sh - uploads a file to https://file.io with 2 weeks, single download retentioncatbox.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)digital_ocean_api.sh / doapi.sh - queries the Digital Ocean API with authenticationdoctl ( install/install_doctl.sh )atlassian_ip_ranges.sh - lists Atlassian's IPv4 and/or IPv6 cidr ranges via its APIcircleci_public_ips.sh - lists CircleCI public IP addresses via dnsjson.comcloudflare_*.sh - Cloudflare API queries and reports:cloudflare_api.sh - queries the Cloudflare API with authenticationcloudflare_ip_ranges.sh - lists Cloudflare's IPv4 and/or IPv6 cidr ranges via its APIcloudflare_custom_certificates.sh - lists any custom SSL certificates in a given Cloudflare zone along with their status and expiry datecloudflare_dns_records.sh - lists any Cloudflare DNS records for a zone, including the type and ttlcloudflare_dns_records_all_zones.sh - same as above but for all zonescloudflare_dns_record_create.sh - creates a DNS record in the given domaincloudflare_dns_record_update.sh - updates a DNS record in the given domaincloudflare_dns_record_delete.sh - deletes a DNS record in the given domaincloudflare_dns_record_details.sh - lists the details for a DNS record in the given domain in JSON format for further pipe processingcloudflare_dnssec.sh - lists the Cloudflare DNSSec status for all zonescloudflare_firewall_rules.sh - lists Cloudflare Firewall rules, optionally with filter expressioncloudflare_firewall_access_rules.sh - lists Cloudflare Firewall Access rules, optionally with filter expressioncloudflare_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 cachecloudflare_ssl_verified.sh - gets the Cloudflare zone SSL verification status for a given zonecloudflare_ssl_verified_all_zones.sh - same as above for all zonescloudflare_zones.sh - lists Cloudflare zone names and IDs (needed for writing Terraform Cloudflare code)datadog_api.sh - queries the DataDog API with authenticationdnsjson.sh - queries dnsjson.com for DNS recordsgitguardian_api.sh - queries the GitGuardian API with authenticationjira_api.sh - queries Jira API with authenticationkong_api.sh - queries the Kong API Gateway's Admin API, handling authentication if enabledtraefik_api.sh - queries the Traefik API, handling authentication if enabledngrok_api.sh - queries the NGrok API with authenticationpingdom_*.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 authenticationpingdom_foreach_check.sh - executes a templated command against each Pingdom check, replacing the {check_id} and {check_name} in each iterationpingdom_checks.sh - show all Pingdom checks, status and latenciespingdom_checks_outages.sh / pingdom_checks_outages.sh - show one or all Pingdom checks outage histories for the last yearpingdom_checks_average_response_times.sh - shows the average response times for all Pingdom checks for the last weekpingdom_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 weekpingdom_sms_credits.sh - gets the remaining number of Pingdom SMS creditsterraform_cloud_api.sh - queries Terraform Cloud API with authenticationterraform_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 functionswordpress.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 backupwordpress_api.sh - queries the Wordpress API with authenticationwordpress_posts_without_category_tags.sh - checks posts (articles) for categories without corresponding tags and prints the posts and their missing tagsjava/ directory:
java_show_classpath.sh - shows Java classpaths, one per line, of currently running Java programsjvm_heaps*.sh - show all your Java heap sizes for all running Java processes, and their total MB (for performance tuning and sizing)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.shjd_gui.sh - runs Java Decompiler JD GUI, downloading its jar the first time if it's not already presentbytecode_viwer.sh - runs Bytecode-Viewer GUI Java decompiler, downloading its jar the first time if it's not already presentcfr.sh - runs CFR command line Java decompiler, downloading its jar the first time if it's not already presentprocyon.sh - runs Procyon command line Java decompiler, downloading its jar the first time if it's not already presentSee also Knowledge Base notes for Java and JVM Performance Tuning.
python/ directory:
python_compile.sh - byte-compiles Python scripts and libraries into .pyo optimized filespython_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 optionpython_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 buildspython_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 repopython_pip_reinstall_all_modules.sh - reinstalls all PyPI modules which can fix some issuespythonpath.sh - prints all Python libary search paths, one per linepython_find_library_path.sh - finds directory where a PyPI module is installed - without args finds the Python library basepython_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 treepython_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.shpython_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.shpython_pyinstaller.sh - creates PyInstaller self-contained Python programs with Python interpreter and all PyPI modules includedpython_pypi_versions.sh - prints all available versions of a given PyPi module using the APISee 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 etcperl_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 buildsperl_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 architectureperlpath.sh - prints all Perl libary search paths, one per lineperl_find_library_path.sh - finds directory where a CPAN module is installed - without args finds the Perl library baseperl_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 treeperl_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-inSee also Knowledge Base notes for Perl.
packages/ directory:
golang_install.sh - bulk installs Golang modules from mix of arguments / file lists / stdingolang_install_if_absent.sh - same as above but only if the package binary isn't already available in $PATHgolang_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 binariesmedia/ directory:
image_join_vertical.sh - joins two images top and bottom after matching their widths so they align correctlyimage_join_horizontal.sh - joins two images left and right after matching their heights so they align correctlyimageopen.sh - opens the given image file using whatever available tool is found on Linux or Macsvg_to_png.sh - convert an SVG image to PNG to be usable on websites that don't support SVG images like LinkedIn, Medium or Redditavif_to_png.sh - convert an Avif image to PNG to be usable on websites that don't support Webp images like LinkedInwebp_to_png.sh - convert a Webp image to PNG to be usable on websites that don't support Webp images like Medium 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 - convert avi files to mp4 using ffmpeg. Useful to be able to play videos on devices like smart TVs that may not recognize newer codecs otherwisemkv_to_mp4.sh - convert mkv files to mp4 using ffmpeg. Same use case as aboveyoutube_download_channel.sh - downloads all videos from a given YouTube channel URLSee 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 formatspotify_playlist_tracks*.sh - gets playlist contents as track URIs / Artists - Track / CSV format - useful for backups or exports between music systemsspotify_backup.sh - backup all Spotify playlists as well as the ordered list of playlistsspotify_backup_playlist*.sh - backup Spotify playlists to local files in both human readable Artist - Track format and Spotify URI format for easy restores or adding to new playlistsspotify_search*.sh - search Spotify's library for tracks / albums / artists getting results in human readable format, JSON, or URI formats for easy loading to Spotify playlistsspotify_release_year.sh - searches for a given track or album and finds the original release yearspotify_uri_to_name.sh - convert Spotify track / album / artist URIs to human readable Artist - Track / CSV format. Takes Spotify URIs, URL links or just IDs. Reads URIs from files or standard inputspotify_create_playlist.sh - creates a Spotify playlist, either public or privatespotify_rename_playlist.sh - renames a Spotify playlistspotify_set_playlists_public.sh / spotify_set_playlists_private.sh - sets one or more given Spotify playlists to public / privatespotify_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 backupsspotify_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 playlistsspotify_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_duplicates_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.shspotify_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.shspotify_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 matchesspotify_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)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 playlistspotify_top_artists*.sh - lists your top artists in URI or human readable formatspotify_top_tracks*.sh - lists top tracks in URI or human readable formatspotify_liked_tracks*.sh - lists your Liked Songs in URI or human readable formatsspotify_liked_artists*.sh - list artists from Liked Songs in URI or human readable formatsspotify_artists_followed*.sh - lists all followed artists in URI or human readable formatsspotify_artist_tracks.sh - gets all track URIs for a given artist, from both albums and single for chain loading to playlistsspotify_follow_artists.sh - follows artists for the given URIs from files or standard inputspotify_follow_top_artists.sh - follows all artists in your current Spotify top artists listspotify_follow_liked_artists.sh - follows artists with N or more tracks in your Liked Songsspotify_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 Songsspotify_foreach_playlist.sh - executes a templated command against all playlists, replacing {playlist} and {playlist_id} in each iterationspotify_playlist_name_to_id.sh / spotify_playlist_id_to_name.sh - convert playlist names <=> IDsspotify_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.shspotify_api.sh - query any Spotify API endpoint with authentication, used by adjacent spotify scripts bin/ , install/ , packages/ , setup/ directories:
install/ - installation scripts for various OS packages (RPM, Deb, Apk) for various Linux distros (Redhat RHEL / CentOS / Fedora, Debian / Ubuntu, Alpine)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 belowinstall_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 aboveyum_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 aboverpms_filter_installed.sh / rpms_filter_not_installed.sh - pipe filter packages that are / are not installed for easy script pipingapt_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 aboveapt_wait.sh - blocking wait on concurrent apt locks to avoid failures and continue when available, mimicking yum's waiting behaviour rather than error'ing outdebs_filter_installed.sh / debs_filter_not_installed.sh - pipe filter packages that are / are not installed for easy script pipingapk_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 aboveapk_filter_installed.sh / apk_filter_not_installed.sh - pipe filter packages that are / are not installed for easy script pipingbrew_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 abovebrew_filter_installed.sh / brew_filter_not_installed.sh - pipe filter packages that are / are not installed for easy script pipingbrew_package_owns.sh - finds which brew package owns a given filename argumentmake 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 generalized tests - these run against all my GitHub repos via CI.一些例子:
Programming language linting:
Build System, Docker & CI linting:
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 linkundo via
make unlinkInstall only OS system package dependencies (doesn't include AWS CLI or Python packages):
make system-packagesInstall AWS CLI:
make awsInstall Azure CLI:
make azureInstall GCP GCloud SDK (includes CLI):
make gcpInstall GCP GCloud Shell environment (sets up persistent OS packages and all home directory configs):
make gcp-shellInstall 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.