概要#

• 技術ブログを立ち上げる目的とか狙いとか、運用で困るといった考察は、TechBlog運用の難しさとHERPでの考えについてに書いてある内容と同じことを考えておりました。ただ、blog hubを立ち上げたくても立ち上げコストがかかるからプライオリティを下げてました。
• そんなところで、@catnose99さんがblog hubを構築するOSSを公開してくれたのでforkして利用してみました。
  • https://github.com/catnose99/team-blog-hub
• Forkしたコードは公開しております
  • https://github.com/minedia/team-blog-hub
• 10分ぐらいで構築できると思います。

主な設定#

コードはNext.jsのSSG(Static Site Generators)で書かれています。ソースコードのコミットログを見てもらえればわかると思いますが、Forkした上で、主な設定はこれ。

https://github.com/minedia/team-blog-hub/commit/640dc1cff76f3b4595045d3574f3b970a9a52f22

設定項目はきれいに外出しされていて超簡単です。

ホスティング#

Vercelを使っています。github organizationと連携するので有料（$20/month）になりますが、最初の2週間は無料です。個人アカウントなら無料のようです。

普通に設定すると minedia-engineer-hub.vercel.app のようなホスト名でホスティングされます。自社ドメインで運用したいので独自ドメインの設定をします。

Vercelの管理画面上で独自ドメイン + TSLの設定をすることになるわけですが、非常に簡単です。まずドメインを新たに追加します。

そのうえで、オーナー確認をするためにDNSの設定を自分のドメインに追加します。初期状態ではドメインの所有者確認ができていないので “Invalid Configuration”と表示されます。　

CNAMEを1つ入れるだけです。

再度設定ページを表示すると、Valid configurationになります。

そしたら、独自ドメインで表示されるようになります。

https://tech-blog.minedia.com/ => zennへ移行しました。https://zenn.dev/p/minedia

githubなので、社内のエンジニアだけでなくbizの人もpull requestを出すことで運用できます。

name: Deploy production site
on:
  schedule:
    - cron: '5 1 * * *'
jobs:
  cron:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: amondnet/vercel-action@v20
        with:
          vercel-token: ${{ secrets.VERCEL_TOKEN }} # Required
          github-token: ${{ secrets.GITHUB_TOKEN }} #Optional
          vercel-args: '--prod' #Optional
          vercel-org-id: ${{ secrets.ORG_ID}}  #Required
          vercel-project-id: ${{ secrets.PROJECT_ID}} #Required
          scope: ${{ secrets.VERCEL_SCOPE }}

まとめ#

• 短時間で会社の技術ブログを立ち上げられました。
• 自分の個人BlogのRSSを登録するということもあり、定期的に記事は書いているので、更新が止まった感じの寂れた感じは出ないはずです。
• 会社で使っているや社内の雰囲気はこちらのスライドを御覧ください。