[Qiita] Git連携 - 基本

要約

• Qiitaの記事をGitHubレポジトリで管理する方法の備忘録
  • Qiitaの記事をGitHubリポジトリで管理する方法
• Qiita公式手順のハンズオン
• Node.jsを使用するためDevcontainerの構築をしたいが次回以降実施

手順

Qiita

1. Qiitaのトークンを発行
   1. 設定 -> アプリケーション -> 個人用アクセストークンから「新しくトークンを発行する」を選択
      
   2. トークンの設定を入力
      アクセストークンの説明はGitHub用と判別可能な任意のテキストを入力
      スコープは「read_qiita」と「write_qiita」を選択
      
   3. 発行されたトークンをコピー
      

GitHub

1. GitHubレポジトリの作成
   
2. GitHub Actionsの設定
   1. Settings -> Secrets and variables -> Actions -> Secretsから「New repository secret」を選択
      
   2. シークレットの設定
      NameにQIITA_TOKENを入力
      Secretに1-3で発行したトークンを入力
      
      

Qiita CLI

1. インストール

   1. qiita-cli
      1. npm install @qiita/qiita-cli --save-dev
         

2. セットアップ

   1. npx qiita init
   2. npx qiita login
      ※恐らくログイン時にはGitHubとは別のトークンを入力するのがベストプラクティス。ここでは同一のトークンを入力
      

GitHubレポジトリと同期

1. リモートレポジトリの追加

   git init
   git add *
   git commit -m "first commit"
   git branch -M main
   git remote add origin [リポジトリのURL]
   

2. リモートレポジトリのPush
   git push -u origin main
   
3. GitHubレポジトリ
   

所感

• Qiita CLIは特に問題なかったが、以下のことからGitHubの操作方法でハマった。業務では漫然とGitを使用していたと反省。Gitを学びなおしたほうがいいかもしれない
  • 普段はAzure DevOpsのReposを使用しており、Repos上からレポジトリを作成->Cloneをしている
  • VSCode上からコミット・Pushをしており、コマンドラインの操作方法が不明だった
• Node.jsを使用するため、Devcontainerとして使用したい。Devcontainerは数回使用したことがあるがいまいち理解していないので理解しながら設定する(ToDo: 1)
  • 主旨は環境を汚染したくないため
  • 元々PCにはNode.js v14がインストールされていた(使用していないが)
  • Qiita CLIのインストールに伴いv22をインストールし直した
• PCに設定されているGitの設定がAzure DevOps Repos用のため設定変更が必要。複数アカウントを使い分けられるように設定する必要がある(ToDo: 2)
  • 今回は面倒になったためユーザ情報をGitHub用に書き換えてしまった