推奨セットアップ

推奨するツール

Homebrew

Homebrew をインストールするには、セットアップスクリプトを使用します。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

rbenv

これは、特に多数の ruby バージョンを使用する際に優れたツールです。ワークステーションへインストールして設定することを強く推奨します。

設定後は、使用頻度の高い ruby バージョンをインストールするために、次のコマンドを推奨します。

• rbenv install 3.0.1
• rbenv install 3.2.2

次に、各 ruby バージョンへ gem install bundler で bundler gemをインストールすることを推奨します。ほとんどのプロジェクトでは Gemfile を使用するため、bundle を実行すればプロジェクトに必要な gem をダウンロードできます。

rbenv の macOS セットアップ

Homebrewを使用すれば簡単に行えます。コマンドは次のとおりです。

brew install rbenv

アップグレードして新しい ruby バージョンを取得する必要がある場合は、次を実行します。

brew upgrade rbenv ruby-build

rbenv の Linux セットアップ

これには apt などのパッケージマネージャーも使用できますが、代わりに git でインストールすることを推奨します。次のコマンドを実行します。

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init - bash)"' >> ~/.bashrc
source ~/.bashrc
mkdir -p "$(rbenv root)"/plugins
git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build
source ~/.bashrc
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/main/bin/rbenv-doctor | bash

rbenv とプラグインをアップグレードするには、次を実行します。

cd ~/.rbenv
git pull
cd ~/.rbenv/plugins/ruby-build
git pull

1Password

これには 2 つの方法があります。

• アプリベース（macOS のみ）
• ブラウザベース

1Password のアプリベースセットアップ

1Password アプリをインストールするには、Homebrewで次のコマンドを使用します。

brew install --cask 1password

アップグレードするには、次を使用します。

brew upgrade --cask 1password

1Password のブラウザベースセットアップ

Chrome ベースのブラウザには、Chrome 用 1Password browser pluginページから追加できます。

Firefox ベースのブラウザには、Firefox 用 1Password browser pluginページから追加できます。

Okta browser plugin

Chrome ベースのブラウザには、Chrome 用 Okta browser pluginページから追加できます。

Firefox ベースのブラウザには、Firefox 用 Okta browser pluginページから追加できます。

インストール後、ブラウザで Okta にログインしていれば動作を開始します。

nodenv

これは、特に多数の node バージョンを使用する際に優れたツールです。ワークステーションへインストールして設定することを強く推奨します。

nodenv の macOS セットアップ

Homebrewを使用すれば簡単に行えます。コマンドは次のとおりです。

brew install nodenv

アップグレードして新しい node バージョンを取得する必要がある場合は、次を実行します。

brew upgrade nodenv node-build

nodenv の Linux セットアップ

これには apt などのパッケージマネージャーも使用できますが、代わりに git でインストールすることを推奨します。次のコマンドを実行します。

git clone https://github.com/nodenv/nodenv.git ~/.nodenv
echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(nodenv init -)"' >> ~/.bashrc
source ~/.bashrc
mkdir -p "$(nodenv root)"/plugins
git clone https://github.com/nodenv/node-build.git "$(nodenv root)"/plugins/node-build
source ~/.bashrc
curl -fsSL https://github.com/nodenv/nodenv-installer/raw/master/bin/nodenv-doctor | bash

nodenv とプラグインをアップグレードするには、次を実行します。

cd ~/.nodenv
git pull
cd ~/.nodenv/plugins/node-build
git pull

.bashrc/.bash_profile/.zshrc のセットアップ

このファイルへ何を記述するかは自分で決められますが、使用するすべてのスクリプトなどが正しく動作するよう、少なくとも次を行うことを推奨します。

# us fed ZD instance
export US_ZD_URL='https://gitlab-federal-support.zendesk.com/api/v2'
export US_ZD_USERNAME='YOUR_EMAIL_ADDRESS'
export US_ZD_TOKEN='ZENDESK_US_GOV_ADMIN_TOKEN'

# main ZD instance
export ZD_URL='https://gitlab.zendesk.com/api/v2'
export ZD_USERNAME='YOUR_EMAIL_ADDRESS'
export ZD_TOKEN='ZENDESK_GLOBAL_ADMIN_TOKEN'

# main sandbox
export ZD_SB_URL='https://gitlab1707170878.zendesk.com/api/v2'
export ZD_SB_USERNAME='YOUR_EMAIL_ADDRESS'
export ZD_SB_TOKEN='ZENDESK_GLOBAL_SANDBOX_ADMIN_TOKEN'

# us fed sandbox
export US_SB_ZD_URL='https://gitlabfederalsupport1585318082.zendesk.com/api/v2'
export US_SB_ZD_USERNAME='YOUR_EMAIL_ADDRESS'
export US_SB_ZD_TOKEN='ZENDESK_US_GOV_SANDBOX_ADMIN_TOKEN'

# GitLab token
export GL_TOKEN='YOUR_GITLAB_TOKEN'

Zendesk トークン

Zendesk 管理者として、API 呼び出しを行う必要が生じる可能性が高いです。API トークンを介して行うのは便利で、多くのスクリプトもこの方法を使用します。そのため、管理する各 Zendesk インスタンス（本番環境とサンドボックス）で、個人用の API トークンを生成することを推奨します。

GitLab トークン

gitlab.com と連携するものを頻繁に作成します。そのため、API 呼び出し用の API トークンを手元に用意しておくと常に便利です。

Slack

Slack で頻繁にコミュニケーションを取るため、これは仕事に必要です。

Slack の macOS セットアップ

Homebrewを使用すれば簡単に行えます。コマンドは次のとおりです。

brew install --cask slack

アップグレードする必要がある場合は、次を実行します。

brew upgrade --cask slack

Slack の Linux セットアップ

Slack ダウンロードページから DEB パッケージをインストールし、次のように DEB ファイルをインストールします。

sudo dpkg -i /absolute/path/to/deb/file
sudo apt-get install -f

Visual Studios Code

これはコードエディターが必要で、特に好みがない場合にのみ必要です。GitLab の複数のメンバーが使用しており、GitLab WebIDE と整合します。

Visual Studios Code の macOS セットアップ

Homebrewを使用すれば簡単に行えます。コマンドは次のとおりです。

brew install --cask visual-studio-code

アップグレードする必要がある場合は、次を実行します。

brew upgrade --cask visual-studio-code

Visual Studios Code の Linux セットアップ

Visual Studios Code ダウンロードリンクから DEB パッケージをインストールし、次のように DEB ファイルをインストールします。

sudo dpkg -i /absolute/path/to/deb/file
sudo apt-get install -f

Zoom

Zoom で頻繁にコミュニケーションを取るため、これは仕事に必要です。

Zoom の macOS セットアップ

Homebrewを使用すれば簡単に行えます。コマンドは次のとおりです。

brew install --cask zoom

アップグレードする必要がある場合は、次を実行します。

brew upgrade --cask zoom

Zoom の Linux セットアップ

Zoom ダウンロードセンターへ移動して DEB ファイルをダウンロードします。次のコマンドでインストールします。

sudo dpkg -i /absolute/path/to/deb/file
sudo apt-get install -f

ファイルシステムのセットアップ

私たちは非常に多くのリポジトリを使用します。GitLab UI で多くの作業を行えますが、最終的にはコマンドラインを使用する必要があります。

そのため、次の 2 点を推奨します。

1. 作業するすべてのリポジトリ（アクセス権があるもの）のローカルクローンを持つ
2. 必要に応じて一括更新するスクリプトを用意する

具体的な方法は自分で決められます。

.
└── dev
    ├── gitlab-com
    └── gitlab-support-readiness

.
└── dev
    └── gitlab-support-readiness
        └── zendesk-global
            └── apps

#!/bin/bash

echo 'Updating Support Readiness repos...'
CWD=$PWD
find /home/jason/dev/gitlab-support-readiness -type d -name .git | while read dir; do
  path=$(echo $dir | sed s_/".git$"__)
  echo "  Updating $path"
  cd $path
  git submodule update --remote --quiet 2>/dev/null
  git pull -q 2>/dev/null
  if [ $? -eq 1 ]; then
    echo "    Branch issue: $(git branch|grep '*')"
  fi
done
find /home/jason/dev/support -type d -name .git | while read dir; do
  path=$(echo $dir | sed s_/".git$"__)
  echo "  Updating $path"
  cd $path
  git submodule update --remote --quiet 2>/dev/null
  git pull -q 2>/dev/null
  if [ $? -eq 1 ]; then
    echo "    Branch issue: $(git branch|grep '*')"
  fi
done
echo "  Updating /home/jason/dev/gitlab-com/content-sites/handbook"
cd /home/jason/dev/gitlab-com/content-sites/handbook
git pull -q 2>/dev/null
if [ $? -eq 1 ]; then
  echo "    Branch issue: $(git branch|grep '*')"
fi
cd $CWD

alias cdops='cd /home/jason/dev/gitlab-support-readiness'
alias cdglobal='cd /home/jason/dev/gitlab-support-readiness/zendesk-global'
alias cdusfed='cd /home/jason/dev/gitlab-support-readiness/zendesk-us-government'
alias cdusgov='cd /home/jason/dev/gitlab-support-readiness/zendesk-us-government'
alias cdforms='cd /home/jason/dev/gitlab-support-readiness/forms'
alias cdprocessor='cd /home/jason/dev/gitlab-support-readiness/processors'
alias cdslack='cd /home/jason/dev/gitlab-support-readiness/slack'
alias cdteam='cd /home/jason/dev/gitlab-support-readiness/support-team'
alias cdhandbook='cd /home/jason/dev/gitlab-com/content-sites/handbook'

## Show branch info on PS1

parse_git_branch() {
  git branch 2> /dev/null | sed -e '/^[^*]/d' -e 's/* \(.*\)/ (\1)/'
}

export PS1="\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\[\e[91m\]\$(parse_git_branch)\[\e[00m\]$ "

便利なリンク

• Homebrew サイト
• rbenv リポジトリ
• Chrome 用 Calendly browser plugin
• Firefox 用 Calendly browser plugin
• Chrome 用 1Password browser plugin
• Firefox 用 1Password browser plugin
• Chrome 用 Okta browser plugin
• Firefox 用 Okta browser plugin
• Slack ダウンロードページ
• Zoom ダウンロードセンター

ページのソースコードを見る - ページの編集 - please contribute.