remove M1 mac setup since it is no longer needed (#4787)
This commit is contained in:
Родитель
b5294fcdbc
Коммит
361dbff8a0
|
@ -1,97 +0,0 @@
|
|||
# M1 Mac Setup Guide
|
||||
|
||||
This guide should get you set up to run `bigquery-etl` on an M1 or M2 Mac. The
|
||||
reason you need to take some extra steps here is because M1/M2 Macs run on
|
||||
Apple CPUs that use ARM architecture, as opposed to what older Macs use, Intel
|
||||
CPUs on x86 architecture. There are currently some compatibility issues between
|
||||
some of our dependencies and ARM. To get around this, we'll use Rosetta, which
|
||||
is an x86 emulator.
|
||||
|
||||
You're free to set this up however you like, but in this guide we'll set up 2
|
||||
parallel Homebrew versions, one for ARM and one for x86 (in Rosetta), create
|
||||
aliases for the two, and install all of `bigquery-etl`'s dependencies in
|
||||
Rosetta mode.
|
||||
|
||||
For tips on maintaining parallel stacks of python and homebrew running with and without Rosetta, see blog posts from [Thinknum](https://medium.com/thinknum/how-to-install-python-under-rosetta-2-f98c0865e012) and [Sixty North](http://sixty-north.com/blog/pyenv-apple-silicon.html).
|
||||
|
||||
> :exclamation: These instructions will install everything in Rosetta mode and
|
||||
> assume that you can do all your work in Rosetta mode.
|
||||
>
|
||||
> If you need to work with other repos outside of Rosetta mode (esp in Python)
|
||||
> these steps are probably not right for you -- ask in #data-help for advice on
|
||||
> getting set up
|
||||
|
||||
1. Install Rosetta if you don't have it yet
|
||||
|
||||
```zsh
|
||||
softwareupdate --install-rosetta
|
||||
```
|
||||
|
||||
2. Set Terminal to run in Rosetta mode:
|
||||
1. In Finder, go to Applications -> Utilities
|
||||
2. Right-click on Terminal and choose Get Info
|
||||
3. Check the box "Open using Rosetta"
|
||||
4. Open a new Terminal session and run `arch`. This will show you the
|
||||
current architecture -- it should output `i386`. If you're not in Rosetta
|
||||
mode, it will output `arm64`
|
||||
5. (Optional) You can add the current architecture to your prompt -- add the
|
||||
following to your `~/.zshrc` or `/.bashrc`:
|
||||
|
||||
```zsh
|
||||
setopt PROMPT_SUBST
|
||||
PROMPT='$(arch) %~ %# '
|
||||
```
|
||||
|
||||
3. Install Homebrew:
|
||||
1. Still in your Rosetta mode shell, follow the instructions at
|
||||
<https://brew.sh/> to install Homebrew
|
||||
2. This will have installed Homebrew to `/usr/local/bin/brew`; now we'll add
|
||||
some aliases -- add the following to your `~/.zshrc` or `/.bashrc`:
|
||||
|
||||
```zsh
|
||||
alias brew86='/usr/local/bin/brew'
|
||||
alias brewm1='/opt/homebrew/bin/brew'
|
||||
alias brew='echo "Use brew86 or brewm1"'
|
||||
```
|
||||
|
||||
You'll now use `brew86` to install things to Rosetta Homebrew and
|
||||
`brewm1` to install to ARM Homebrew. The third alias I added because I
|
||||
kept just typing `brew` out of habit without knowing which one I was
|
||||
using
|
||||
3. Delete the following line from your `~/.zprofile` or `~/bash_profile` if
|
||||
you previously added it:
|
||||
|
||||
```zsh
|
||||
eval "$(/opt/homebrew/bin/brew shellenv)"
|
||||
```
|
||||
|
||||
4. (Recommended) Clear out non-Rosetta versions of software that's used in
|
||||
`bigquery-etl`:
|
||||
1. If you installed Python 3.10 via pyenv, uninstall it with
|
||||
|
||||
```zsh
|
||||
pyenv uninstall 3.10.6 # (or whichever version you have installed)
|
||||
```
|
||||
|
||||
2. If you installed pyenv, uninstall it:
|
||||
|
||||
```zsh
|
||||
brewm1 uninstall pyenv
|
||||
```
|
||||
|
||||
3. If you're using tmux or something like that, uninstall that too and
|
||||
reinstall via `brew86`
|
||||
5. Install the core `bigquery-etl` dependencies via `brew86`:
|
||||
|
||||
```zsh
|
||||
brew86 install pyenv
|
||||
```
|
||||
|
||||
6. Install python; you'll need to install `xz` first
|
||||
|
||||
```zsh
|
||||
brew86 install xz
|
||||
pyenv install 3.10.6 # (or whichever version)
|
||||
```
|
||||
|
||||
You should now be set to run through the [`bigquery-etl` setup instructions](README.md#quick-start)
|
|
@ -12,11 +12,6 @@ For more information, see [https://mozilla.github.io/bigquery-etl/](https://mozi
|
|||
|
||||
## Quick Start
|
||||
|
||||
> :exclamation: Apple Silicon (M1) user requirement
|
||||
>
|
||||
> Enable [Rosetta mode](https://support.apple.com/en-ca/HT211861) for your terminal _**BEFORE**_ installing below tools using your terminal. See our [M1 Mac
|
||||
> Setup Guide](M1_MAC_SETUP.md) for more information
|
||||
|
||||
### Pre-requisites
|
||||
- **Pyenv** (optional) Recommended if you want to install different versions of python, see instructions [here](https://github.com/pyenv/pyenv#basic-github-checkout). After the installation of pyenv, make sure that your terminal app is [configured to run the shell as a login shell](https://github.com/pyenv/pyenv/wiki/MacOS-login-shell).
|
||||
- **Homebrew** (not required, but useful for Mac) - Follow the instructions [here](https://brew.sh/) to install homebrew on your Mac.
|
||||
|
|
Загрузка…
Ссылка в новой задаче