mac-dev-playbook

mac-dev-playbook

使用Ansible自动化配置Mac开发环境的开源项目

Mac-dev-playbook是一个基于Ansible的开源项目,用于自动化配置macOS开发环境。它可批量安装和设置Web与软件开发所需的应用程序、工具和包管理器。项目支持自定义安装内容,允许配置dotfiles和系统偏好。通过简化环境搭建流程,该项目有助于提高开发效率并保持不同Mac之间的一致性。

Mac开发环境Ansible自动化配置HomebrewdotfilesGithub开源项目

Mac 开发 Ansible Playbook

CI

这个 playbook 安装和配置了我在 Mac 上用于 Web 和软件开发的大部分软件。macOS 中有些东西略难自动化,所以我还有一些手动安装步骤,但至少这里都有记录。

安装

  1. 确保已安装 Apple 的命令行工具(运行 xcode-select --install 启动安装程序)。

  2. 安装 Ansible

    1. 运行以下命令将 Python 3 添加到 $PATH:export PATH="$HOME/Library/Python/3.9/bin:/opt/homebrew/bin:$PATH"
    2. 升级 Pip:sudo pip3 install --upgrade pip
    3. 安装 Ansible:pip3 install ansible
  3. 克隆或下载此仓库到本地驱动器。

  4. 在此目录内运行 ansible-galaxy install -r requirements.yml 来安装所需的 Ansible 角色。

  5. 在此目录内运行 ansible-playbook main.yml --ask-become-pass。当提示输入 'BECOME' 密码时,输入你的 macOS 账户密码。

注意:如果某些 Homebrew 命令失败,你可能需要同意 Xcode 的许可或修复其他 Brew 问题。运行 brew doctor 查看是否属于这种情况。

用于远程 Mac

你也可以使用这个 playbook 来管理其他 Mac;playbook 甚至不需要在 Mac 上运行!如果你想管理远程 Mac,无论是网络上的另一台 Mac,还是像 MacStadium 提供的托管 Mac,你只需确保可以通过 SSH 连接到它:

  1. (在你要连接的 Mac 上:)转到系统偏好设置 > 共享。
  2. 启用"远程登录"。

你也可以在命令行启用远程登录:

sudo systemsetup -setremotelogin on

然后编辑此仓库中的 inventory 文件,将以 127.0.0.1 开头的行更改为:

[mac 的 ip 地址或主机名]  ansible_user=[mac ssh 用户名]

如果你需要提供 SSH 密码(如果你不使用 SSH 密钥),确保在 ansible-playbook 命令中传递 --ask-pass 参数。

运行特定标记的任务集

你可以使用 ansible-playbook--tags 标志指定一组标记来过滤要运行的配置过程部分。可用的标记有 dotfileshomebrewmasextra-packagesosx

ansible-playbook main.yml -K --tags "dotfiles,homebrew"

覆盖默认设置

并非每个人的开发环境和首选软件配置都相同。

你可以通过创建 config.yml 文件并在该文件中设置覆盖项来覆盖 default.config.yml 中配置的任何默认值。例如,你可以使用类似以下内容自定义已安装的包和应用:

homebrew_installed_packages: - cowsay - git - go mas_installed_apps: - { id: 443987910, name: "1Password" } - { id: 498486288, name: "Quick Resizer" } - { id: 557168941, name: "Tweetbot" } - { id: 497799835, name: "Xcode" } composer_packages: - name: hirak/prestissimo - name: drush/drush version: '^8.1' gem_packages: - name: bundler state: latest npm_packages: - name: webpack pip_packages: - name: mkdocs configure_dock: true dockitems_remove: - Launchpad - TV dockitems_persist: - name: "Sublime Text" path: "/Applications/Sublime Text.app/" pos: 5

config.yml 中可以覆盖任何变量;请参阅支持角色的文档以获取可用变量的完整列表。

包含的应用程序 / 配置(默认)

应用程序(使用 Homebrew Cask 安装):

通过Homebrew安装的软件包:

  • autoconf
  • bash-completion
  • doxygen
  • gettext
  • gifsicle
  • git
  • gh
  • go
  • gpg
  • httpie
  • iperf
  • libevent
  • sqlite
  • nmap
  • node
  • nvm
  • php
  • ssh-copy-id
  • cowsay
  • readline
  • openssl
  • pv
  • wget
  • wrk
  • zsh-history-substring-search

我的dotfiles也会被安装到当前用户的主目录中,包括用于配置macOS多个方面以提高性能和易用性的.osx文件。你可以通过在配置中设置configure_dotfiles: no来禁用dotfiles管理。

最后,还为各种应用和服务添加了一些其他偏好设置。

完整/从头开始的设置指南

由于我已经使用这个剧本设置了大约20台不同的Mac,我决定为自己写一份完整的100%从头开始安装的参考文档(每个人的特定安装会略有不同)。

你可以在这里查看我的完整从头开始设置文档:full-mac-setup.md

测试剧本

很多人问我是否经常擦除整个工作站并从头开始,只是为了测试对剧本的更改。不是的!这个项目在GitHub Actions的macOS基础设施上持续测试

你也可以在虚拟机中运行macOS本身,至少可以进行一些必要的测试(App Store应用和一些专有软件可能无法正确安装)。我目前推荐:

Ansible for DevOps

查看Ansible for DevOps,它教你如何使用Ansible自动化几乎任何事情。

作者

这个项目由Jeff Geerling创建(最初受到MWGriffin/ansible-playbooks的启发)。

编辑推荐精选

商汤小浣熊

商汤小浣熊

最强AI数据分析助手

小浣熊家族Raccoon,您的AI智能助手,致力于通过先进的人工智能技术,为用户提供高效、便捷的智能服务。无论是日常咨询还是专业问题解答,小浣熊都能以快速、准确的响应满足您的需求,让您的生活更加智能便捷。

imini AI

imini AI

像人一样思考的AI智能体

imini 是一款超级AI智能体,能根据人类指令,自主思考、自主完成、并且交付结果的AI智能体。

Keevx

Keevx

AI数字人视频创作平台

Keevx 一款开箱即用的AI数字人视频创作平台,广泛适用于电商广告、企业培训与社媒宣传,让全球企业与个人创作者无需拍摄剪辑,就能快速生成多语言、高质量的专业视频。

即梦AI

即梦AI

一站式AI创作平台

提供 AI 驱动的图片、视频生成及数字人等功能,助力创意创作

扣子-AI办公

扣子-AI办公

AI办公助手,复杂任务高效处理

AI办公助手,复杂任务高效处理。办公效率低?扣子空间AI助手支持播客生成、PPT制作、网页开发及报告写作,覆盖科研、商业、舆情等领域的专家Agent 7x24小时响应,生活工作无缝切换,提升50%效率!

TRAE编程

TRAE编程

AI辅助编程,代码自动修复

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
蛙蛙写作

蛙蛙写作

AI小说写作助手,一站式润色、改写、扩写

蛙蛙写作—国内先进的AI写作平台,涵盖小说、学术、社交媒体等多场景。提供续写、改写、润色等功能,助力创作者高效优化写作流程。界面简洁,功能全面,适合各类写作者提升内容品质和工作效率。

AI辅助写作AI工具蛙蛙写作AI写作工具学术助手办公助手营销助手AI助手
问小白

问小白

全能AI智能助手,随时解答生活与工作的多样问题

问小白,由元石科技研发的AI智能助手,快速准确地解答各种生活和工作问题,包括但不限于搜索、规划和社交互动,帮助用户在日常生活中提高效率,轻松管理个人事务。

热门AI助手AI对话AI工具聊天机器人
Transly

Transly

实时语音翻译/同声传译工具

Transly是一个多场景的AI大语言模型驱动的同声传译、专业翻译助手,它拥有超精准的音频识别翻译能力,几乎零延迟的使用体验和支持多国语言可以让你带它走遍全球,无论你是留学生、商务人士、韩剧美剧爱好者,还是出国游玩、多国会议、跨国追星等等,都可以满足你所有需要同传的场景需求,线上线下通用,扫除语言障碍,让全世界的语言交流不再有国界。

讯飞智文

讯飞智文

一键生成PPT和Word,让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目,能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定,还是学生群体的职业生涯规划、实习避坑指南,亦或是活动策划、旅游攻略等内容,它都能提供支持,帮助用户精准表达,轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
下拉加载更多