Skip to content

Latest commit

 

History

History
676 lines (404 loc) · 22.5 KB

ubuntu.cn.md

File metadata and controls

676 lines (404 loc) · 22.5 KB
Raw

电脑设置教程

以下的教程将会帮助你为接下来在Le Wagon Web Development course全栈开发训练营中做好准备：

请仔细阅读并按顺序执行指令。如果你在哪一步卡住了，不用犹豫，可以举手咨询老师:raising_hand:

让我们开始吧 🚀

Zoom

为了让我们能够线上的交流，我们将会使用Zoom，一个视频会议工具。

⚠️ 如果你已经安装了Zoom，请确保它的版本至少是5.6。

打开https://zoom.us/download。

在**Zoom会议客户端（Zoom Client）下方点击下载（Download）**按钮。

打开你刚刚下载的文件并安装应用程序。

打开Zoom。

如果你已经有Zoom账号了，那就用你的账号密码登陆吧。

如果没有账号的话，点击Sign Up Free链接：

Sign Up Free to Zoom

接下来，它会跳转到Zoom的网站让你填一个表。

完成这个表之后，回到Zoom软件，然后用你的账号密码登陆吧。

你应该会看到下面这个界面：

Zoom Home Screen

现在你可以关掉Zoom了。

GitHub账户

你有注册好GitHub账户嘛？如果还没有，现在注册。

👉 上传一张照片 并在你的GitHub账户中设置你的名称。这一步很重要，因为我们将使用一个带有你头像的内部dashboard。请现在立即做这一步，然后再去继续下面的步骤。

启用双因素认证（2FA）。当您尝试登录时，GitHub将向您发送带有代码的短信。这对于安全性很重要，也很快将成为贡献GitHub上的代码的必要条件。

Visual Studio Code

安装

让我们一起安装Visual Studio Code代码编辑器。

复制(Ctrl + C)下面的指令，并粘贴(Ctrl + Shift + v)到终端里：

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
rm -f packages.microsoft.gpg
sudo apt update
sudo apt install -y code

这些命令需要你输入密码的时候，请输入！

⚠️ 你输入密码的时候，屏幕上不会显示你在输入任何东西，这是正常的。这是一个安全措施，保证别人不会看到你的密码内容以及长度。所以输入完成后，敲击回车键（Enter）即可。

用终端打开VS Code（Visual Studio Code)

现在我们来从终端打开VS Code吧：

code

✔️ 如果VS Code窗口打开了，就没什么问题，进入下一步吧 👍

❌ 如果没有的话，请向老师求助。

VS Code 插件

安装

现在我们来给 VS Code 安装一些有用的插件吧。

复制粘贴下面的命令到终端：

code --install-extension ms-vscode.sublime-keybindings
code --install-extension emmanuelbeziat.vscode-great-icons
code --install-extension MS-vsliveshare.vsliveshare
code --install-extension rebornix.ruby
code --install-extension dbaeumer.vscode-eslint
code --install-extension Rubymaniac.vscode-paste-and-indent
code --install-extension alexcvzz.vscode-sqlite
code --install-extension anteprimorac.html-end-tag-labels

你安装的就是下面这些插件：

Command line tools

Zsh & Git

我们将使用zsh来代替默认的bash shell。

我们也会使用git，它是一个用来进行版本控制的命令行软件。

下面来安装这些工具吧：

  • 打开终端
  • 复制粘贴下面的命令：
sudo apt update
sudo apt install -y curl git imagemagick jq unzip vim zsh

这些指令会问你的密码：输入你的密码。

⚠️ 当你输入你的密码的时候，屏幕上不会有任何的显示，这是正常的。这是一个安全保护的设置，来隐藏你整个密码，包括它的长度。你可以放心的输入你的密码，结束后按下Enter就可以了。

安装GitHub CLI

现在我们来安装GitHub官方命令行界面（CLI) (Command Line Interface)。这是一个用来在终端里和你的GitHub账户交互的一个软件。

在你的终端里，复制粘贴以下代码，并在需要的时候，输入你的密码:

sudo apt remove -y gitsome # gh command can conflict with gitsome if already installed
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install -y gh

你可以运行以下的命令，来检查gh是否成功安装了：

gh --version

✔️ 如果你看到了gh version X.Y.Z (YYYY-MM-DD)，你就可以继续下一步啦！:+1:

❌ 如果没有看到话，问问老师。

Oh-my-zsh

让我们一起安装zsh插件Oh My Zsh.

在终端terminal里执行以下指令：

sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

如果终端里出现询问"Do you want to change your default shell to zsh?", 可以输入Y

在你的终端的最后，你会看到以下内容:

带有OhMyZsh的Ubuntu终端

✔️ 如果你的终端成功显示了上面，你就可以继续下一步了👍

❌ 如果安装失败的话，请询问你的老师

GitHub CLI

CLI是Command-line Interface（命令行界面）的首字母缩写。

在这一章节里面，我们会安装GitHub CLI。这样我们就可以直接在终端和Github互动。

你之前执行的命令应该已经安装了GitHub CLI。

首先你需要登陆。复制粘贴下面的命令到终端，敲击回车：

⚠️ 不要更改下面指令中的email

gh auth login -s 'user:email' -w

gh会问你几个问题：

What is your preferred protocol for Git operations?（你要用什么协议来执行Git操作？） 让箭头>停在SSH前面，然后敲击回车。SSH使用SSH密钥来登陆用户，而不是用用户名和密码。

Generate a new SSH key to add to your GitHub account?（生成新的SSH密钥，然后添加到Github账号上？） 敲击回车，让gh帮你生成。

如果你以前生成过SSH密钥，那你就会看到这个问题Upload your SSH public key to your GitHub account?（上传公共密钥到Github账户上上吗？） 上下移动箭头>，让它停在你想选的SSH公钥前面，然后敲击回车。

Enter a passphrase for your new SSH key (Optional)（输入新的SSH密钥的密码（非必填））. 输入一个密码，然后写下来或者记住它。这是保护你本地私钥的密码。然后敲击回车。

Title for your SSH key。你可以把它留在建议的 "GitHub CLI"，按Enter。

然后你会看到下面的文字输出：

! First copy your one-time code: 0EF9-D015
- Press Enter to open github.com in your browser...

复制那段验证码（code）(在上面的例子中是0EF9-D015 ），然后敲击Enter。

你的浏览器就会打开一个页面让你授权GitHub CLI使用你的GitHub账号。同意，并等待一会儿。

回到终端，再次敲击回车，然后就应该好啦:tada:

检查一下你有没有链接好：

gh auth status

如果你看到Logged in to github.com as <你的GitHub用户名> ，那就可以了。

❌ 如果没有，问问老师。

Dotfiles (标准配置)

黑客很喜欢把他们的shell和工具变得很酷炫。

让我们用Le Wagon提供的一个超棒的默认配置文件来开始吧：lewagon/dotfiles.

因为你的配置是私人的，所以你需要保存在自己的代码库里（repository/repo）。

Fork的意思是：在你的GitHub账号上建一个新的代码库，和原始的那一个是一模一样的（可以想象成你在复制粘贴这个代码库）。这样，你在你的GitHub上就会有一个新的代码库： $GITHUB_USERNAME/dotfiles。我们需要fork，因为每个人都需要在那些文件里加上一些特定信息（比如你的名字）。

打开终端，运行下面的命令：

export GITHUB_USERNAME=`gh api user | jq -r '.login'`
echo $GITHUB_USERNAME

✔️ 你应该能看到你的GitHub用户名在终端里显示出来了。

❌ 如果没有的话，现在就停下，找老师帮忙。看起来之前的步骤(gh auth)有一些问题。

现在就可以fork代码库（repo)，然后克隆到你自己的电脑上了：

mkdir -p ~/code/$GITHUB_USERNAME && cd $_
gh repo fork lewagon/dotfiles --clone

Dotfiles安装器

运行dotfiles安装器：

cd ~/code/$GITHUB_USERNAME/dotfiles && zsh install.sh

用下面的命令检查一下你GitHub账号录入的电子邮箱。你需要在其中选一个（如果你有好几个的话），然后再进入下一个步骤：

gh api user/emails | jq -r '.[].email'

✔️ 如果你看到了你的注册邮箱列表，你就可以继续下一步啦👍

❌ 如果没有的话，请在运行上面☝️ 这个指令之前，重新授权GitHub。

git安装器

运行git安装器：

cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh

☝️ 这会提示填写你的全名（FirstName LastName）和你的邮箱。

⚠️ 注意啦，你需要填gh api ...命令列出的其中一个电子邮箱。不然，Kitt就没办法跟进你的学习进程。 你选择的电子邮件将公开显示在互联网上。💡 如果您不希望您的电子邮件出现在您可能会贡献的公共存储库中，请选择 @users.noreply.github.com 地址。

现在运行下面的命令来重置你的终端：

exec zsh

禁用SSH密码输入

每次跟远程的代码库交流的时候都问你要密码是件很烦的事。所以呀，你需要给oh my zsh加上一个ssh-agent插件：

首先，打开.zshrc文件：

code ~/.zshrc

然后：

  • 找到plugins=开始的这一行
  • 在插件（plugin）列表里加上ssh-agent

这个列表现在看起来应该是这样的：

plugins=(gitfast last-working-dir common-aliases zsh-syntax-highlighting history-substring-search pyenv ssh-agent)

✔️ 按下Ctrl + S 保存.zshrc文件，然后关掉你的代码编辑器。

rbenv

让我们安装rbenv，一个帮助我们安装和管理ruby环境的软件。

首先，我们需要清理你可能已经安装过的Ruby:

rvm implode && sudo rm -rf ~/.rvm
# If you got "zsh: command not found: rvm", carry on.
# It means `rvm` is not on your computer, that's what we want!
rm -rf ~/.rbenv

然后在终端里运行:

sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
exec zsh

Ruby

安装

现在，你已经准备好了去安装最新ruby版本并把它设置为默认版本。

运行下方这个指令，它会花费一些时间（5-10分钟）

rbenv install 3.3.5

当Ruby安装好后，运行下面这个指令来告诉系统使用3.3.5这个版本作为默认版本。

rbenv global 3.3.5

然后重置你的终端，然后检查Ruby版本：

exec zsh
ruby -v

✔️ 如果你有看到ruby 3.3.5，那么你可以继续下一步+1:

❌ 如果没有的话，询问一下老师。

安装一些gems

点击这里，如果你在 🇨🇳 中国的话

⚠️ 如果你在中国的话，你应该使用以下命令来安装gem。

# China only!
gem sources --remove https://rubygems.org/
gem sources -a https://gems.ruby-china.com/
gem sources -l
# *** CURRENT SOURCES ***
# https://gems.ruby-china.com/
# Ruby-china.com must be in the list now

在ruby的世界里，我们将外部的库称之为gems：他们是一些你可以下载并在你的电脑上运行的ruby代码。让我们一起安装一些!

首先，我们将更新bundler，它是用于安装 gem 的工具：

gem update bundler

在你的终端里，复制粘贴下面的指令：

gem install colored faker http pry-byebug rake rails:7.1.3.4 rest-client rspec rubocop-performance sqlite3:1.7.3 activerecord:7.1.3.2

✔️ 如果你看到 xx gems installed，那么一切正常 👍

❌ 如果你遇到了以下的报错：

ERROR: While executing gem ... (TypeError)
incompatible marshal file format (can't be read)
format version 4.8 required; 60.33 given

运行以下的指令：

rm -rf ~/.gemrc

然后，重新运行安装gems的指令。

⚠️ 永远不要使用sudo gem install来安装一个gem！即使你偶然发现了一个网络上的答案（或者终端提示）叫你这么做。

Node.js

Node.js是一个JavaScript运行环境以在终端运行JavaScript代码。让我们一起用nvm，一个Node.js的版本管理器，来安装Node.js。

在终端里，运行以下指令：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh

重启你的终端并执行下方指令：

nvm -v

你应该会看到你的nvm的版本。如果没有的话，问一下你的老师。

现在，让我们来安装node：

nvm install 20.17.0

当这个指令执行结束之后，运行：

node -v

如果看到v20.17.0，那么你安装成功了:heavy_check_mark: 然后，你就可以运行下面这个命令了：

nvm cache clear

❌ 如果没有看到版本的话，问一下你的老师。

yarn

让我们一起来安装yarn:

corepack enable
yarn set version stable
exec zsh

⚠️ 如果你看到任何错误信息，请尝试运行 npm install -g corepack 然后再次运行上面的命令。

重启终端并运行：

yarn -v

你应该会看到你yarn的版本。如果没有的话，问一下你的老师。

SQLite

几周后，我们就会开始学习数据库和SQL. SQLite是一个数据库引擎，它可以在单文件数据库上执行SQL查询。现在来安装它吧：

在终端，执行下面的命令：

sudo apt-get install sqlite3 libsqlite3-dev pkg-config

然后执行下面的命令：

sqlite3 -version

✔️ 如果你看到了版本号，那你就可以继续下一步了 👍

❌ 如果没有，问问老师吧！

PostgreSQL

有的时候，SQLite功能会不够用。这个时候我们就需要使用一个更高级的工具，叫做PostgreSQL。这是一个开源的、强大的、生产环境可用的数据库系统。

让我们现在一起安装它。

运行下方指令:

sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential
sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;"

最后检查

让我们来看看你是否已经成功安装好了所有软件。

在终端，运行下面两行命令：

exec zsh
curl -Ls https://web-dev-challenge-lewagon-image.oss-cn-shanghai.aliyuncs.com/setup/check.rb > _.rb && ruby _.rb || rm _.rb

✔️ 如果出现了一个绿色的Awesome! Your computer is now ready!，那么你的工作台已经设置好了 👍

如果没有的话，问一下你的老师。

Kitt

⚠️ 如果你已经收到了一封来自Le Wagon邀请你去注册Kitt(我们的学习平台)的邮件并且你也注册完成了的话，你可以安全的跳过这一章节。如果你还没有注册完成的话，请跟随邮件里的教程，完成注册。

如果你不确定你要做什么，可以查看这个链接。如果你已经登录了的话，你可以跳过这个章节。如果你没有登录的话，你需要点击Enter Kitt as a Student。如果你可以成功的登录，你也可以安全的跳过这一步。不然的话，你可以询问一下老师你是否有收到过相关的邮件，或者直接跟着执行下面的教程。

前往kitt.lewagon.com/onboarding，注册成为Le Wagon的一名校友。选择你的batch，用gitHub账户登录并填写你的信息。

你的老师将会验证你的确属于这个batch。你可以在完成了注册表单后去询问老师去做验证。

当你的老师验证成功后，请前往你的邮箱收件箱。你应该会有两封邮件：

  • 一封来自Slack,邀请你加入Le Wagon Alumni Slack社群（在这儿你可以与你的伙伴和所有之前的学员交流）。点击Join并填写相应的个人信息。

  • 一封来自GitHub,要求你加入lewagon团队。接受它，不然的话你将没有办法看到有关讲座和课程的文件。

Slack

Install Slack for Linux (beta).

Launch the app and sign in to lewagon-alumni organization.

Make sure you upload a picture there.

You can also sign in to Slack on your iPhone or Android device!

The idea is that you'll have Slack open all day, so that you can share useful links / ask for help / decide where to go to lunch / etc.

In case of remote tickets, you will use Slack audio or video call to get help. To ensure that everything is working fine, launch the Slack app on your computer, then follow this procedure (tl;dr type /call --test then the Enter key in any channel).

After the test are finished, you should have green "All clear" messages at least for your microphone and camera. If not, ask a teacher.

设置

打开Slack应用程序并登入lewagon-alumni组织。

确保你已经上传了你的头像照片 👇

如何上传一张头像照片

之后你可以全天开着Slack，这样你可以在上面分享有用的链接/寻求帮助/决定去那儿吃饭/...

为了确保视频电话可以正常工作，让我们一起测试摄像头和麦克风：

  • 打开Slack应用程序。
  • 点击右上方的个人照片。
  • 从菜单中选择 首选项(Preferences)。
  • 点击左侧栏中的 音频和视频(Audio & video)。
  • 在 故障排除(Troubleshooting)下面，点击 运行音频、视频和屏幕共享测试(Run an audio, video and screensharing test)。该测试将在一个新窗口中打开。
  • 检查你使用的扬声器、麦克风和摄像机设备是否出现在选项中，然后点击 开始测试(Start test)。

在Slack检查麦克风和摄像头

✔️ 当测试结束以后，你应该会看到你的摄像头和麦克风有绿色的"Succeed"信息。👍

❌ 如果测试失败的话，请联系你的老师.

你也可以在手机上安装Slack应用并登入lewagon-alumni!

Ubuntu settings

Install video codec H264

On our pedagogical platform (Kitt, you'll soon discover it!), we have some videos. By default Firefox on Linux cannot play them as they use an unsupported codec (H264). To get those videos working for you, you need to run this:

sudo apt install libavcodec-extra -y

Install useful terminal tools

tree is a nice tool to visualize a directory tree inside the terminal:

ncdu is a text-based interface disk utility.

htop is an interactive process viewer.

tig is a text-mode interface for git.

sudo apt install tree ncdu htop tig

Ubuntu inotify

Ubuntu is always tracking changes in your folders and to do this it uses inotify. By default the Ubuntu limit is set to 8192 files monitored.

As programming involves a lot of files, we need to raise this limit. In your terminal run:

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

Pin apps to your dock

You are going to use most of the apps you've installed today really often. So let's pin them to your dock so that they are just one click away!

To pin an app to your dock, launch the app, right-click on the icon in the dock to bring up the context menu and choose "Add to Favorites".

How to pin an app to the dock in Ubuntu

You must pin:

  • Your terminal
  • Your file explorer
  • VS Code
  • Your Internet browser
  • Slack
  • Zoom

设置完成啦!

现在你的电脑已经完成Le Wagon网页开发课程的设置啦 💪 👏

享受你的编程之旅，你会掌握它的！ 🚀