Skip to content

setup.md

Latest commit

 

History

History
245 lines (174 loc) · 9.57 KB

setup.md

File metadata and controls

245 lines (174 loc) · 9.57 KB

Top
前: -
次: CloudNativeの基礎

環境セットアップ

プラクティスを始める前に環境を準備します。以下の手順に従って、GitHubアカウントの作成、PATの作成、端末の準備、リポジトリの準備を行ってください。

GitHubの準備

アカウントの作成

GitHubの個人アカウントを持っていない場合は次の公式ドキュメントを参考にアカウントを作成してください。GitHub でのアカウントの作成

PATの作成

GitHubアカウントの個人アクセストークン(PAT)を持っていない場合は次の公式ドキュメントを参考に作成してください。GitHub での個人用アクセストークンの作成

権限は以下が最低限ついていればいいです。

  • Fine-grained tokens の場合
    • Repository access
      • All repositories
    • Repository permissions
      • Issues: Read & Write
      • Contents: Read & Write
      • Metadata: Read (他の権限付けると自動でつくはず)
      • Workflows: Read & Write
  • Personal access tokens (classic)の場合
    • repo
    • workflow

端末の準備

Linuxを想定しています。Linux環境がない場合、次を参考にlinux環境を構築してください。bastion

各種コマンド確認

Linux環境で以下コマンドが使えることを確認してください。

git

git --version

インストールされていない場合、次を参考にインストールしてください。Gitのインストール

aws

aws --version

インストールされていない場合、次を参考にインストールしてください。AWS CLIのインストール

また、CLIの設定がこれからプラクティスで使用するAWSアカウントになっているかも確認してください。

aws sts get-caller-identity

aws configureが済んでいない場合、次を参考に設定してください。AWS CLIの設定

terraform

terraform version

インストールされていない場合、次を参考にインストールしてください。Terraformのインストール

kubectl

kubectl version --client

インストールされていない場合、次を参考にインストールしてください。kubectlのインストール

python

python --version

または

python3 --version

python3を使用してください。 インストールされていない場合、次を参考にインストールしてください。Pythonのインストール

docker

docker --version

インストールされていない場合、次を参考にインストールしてください。

helm

helm version

インストールされていない場合、次を参考にインストールしてください。Helmのインストール

リポジトリの準備

CNC4Eのリポジトリをコピーして自身のGitHubアカウントにプライベートなリポジトリを作成します。

なぜフォークしないのか？
プラクティス用のリポジトリに間違えて機微な情報をコミットしてしまった場合の影響を抑えるためフォークではなくプライベートな新しいリポジトリを作成します。

空のリポジトリを作成

自身のGitHubアカウントにプライベートな空のリポジトリを作成します。以下の手順で行います。

  • 自身のGitHubアカウントでGitHubにログイン
  • 左メニューからNewを選択 create-repo-1
  • 以下の情報を入力してCreate repositoryをクリック
    • Repository name: cloudnative-practice
    • Visibility: Private create-repo-2

cnc4eのリポジトリをクローン

cnc4eのリポジトリをクローンします。任意のディレクトリで以下のコマンドを実行してください。

git clone --bare https://github.com/cnc4e/cloudnative-practice.git

クローンしたディレクトリに移動し、自身のGitHubアカウントに新しいリポジトリを作成します。以下のコマンドを実行してください。

cd cloudnative-practice.git
git push --mirror https://github.com/{あなたのGitHubアカウント名}/cloudnative-practice.git
Username for 'https://github.com': {あなたのGitHubアカウント名}
Password for 'https://{あなたのGitHubアカウント名}@github.com': {あなたのGitHubアカウントのPAT}

自身のGitHubアカウントにリポジトリを作成したら一旦クローンしたディレクトリを削除します。

cd ..
rm -rf cloudnative-practice.git

自身のGitHubアカウントのリポジトリをクローン

自身のGitHubアカウントに作成したリポジトリを作業端末にクローンします。任意のディレクトリに移動して以下のコマンドを実行してください。

git clone https://github.com/{あなたのGitHubアカウント名}/cloudnative-practice.git
Username for 'https://github.com': {あなたのGitHubアカウント名}
Password for 'https://{あなたのGitHubアカウント名}@github.com': {あなたのGitHubアカウントのPAT}

cnc4eのリポジトリをupstreamとして追加

cd cloudnative-practice
git remote add upstream https://github.com/cnc4e/cloudnative-practice.git

cnc4eのリポジトリで更新があった場合、以下のコマンドで最新の状態に更新できます。

git fetch upstream
git merge upstream/main

(任意)レビュアーを追加

プラクティスは一人で進めることもできますが他の人にレビューしてもらうことでより良いコードを書くことができます。 レビュアーを追加する場合、以下の手順で行います。

  • 自身のGitHubアカウントでGitHubにログイン
  • 作成したリポジトリcloudnative-practiceのページに移動
  • Settingsタブをクリック review-1
  • 左側のメニューからCollaboratorsを選択 review-2
  • Add peopleをクリック review-3
  • レビュアーにしたいGitHubアカウント名Find peopleを入力し、Add をクリック review-4
  • 追加したレビューア宛てにGitHubから招待メールが送信されます。View invitationを選択 review-5
  • Accept invitationすることでリポジトリにアクセスできるようになります。 review-6

(任意)ユーザー名・パスワードの省略

GitHubのリポジトリをクローンした後、毎回ユーザー名とパスワードを入力するのは面倒です。以下の手順で省略できます。

  • クローンしたリポジトリのルートにある.gitディレクトリに移動
  • configファイルを開き以下のように編集します。https://github.com...の//とgithub.comの間に{あなたのGitHubアカウント名}:{あなたのPAT}@を追加します。
...
[remote "origin"]
        url = https://{あなたのGitHubアカウント名}:{あなたのPAT}@github.com/{あなたのGitHubアカウント名}/cloudnative-practice.git
...

プラクティスの開始

これで環境の準備が完了しました。次の章からプラクティスを開始してください。

Top
前: -
次: CloudNativeの基礎