開発チームと運用チームの一貫したワークフローを構築する方法

GitHubが最近発表した「2022 State of the Octoverse」レポートにおいて、HashiCorp Configuration Language（HCL）がGitHubで最も成長したプログラミング言語となりました。HashiCorpは、クラウドコンピューティングのためのInfrastructure as Code (IaC) 自動化のリーディングプロバイダーです。HCLは、Terraformや Vaultなどのツールと共に使用されるHashiCorpの設定言語で、マルチクラウドやオンプレミス環境において、人間が読みやすい設定ファイルでIaC機能を提供することができます。 HCLの成長は、インフラ、運用、開発者の世界を一つにすることの重要性を示しています。これは常にDevOpsの目標でした。しかし、現実には、多くの企業でこれらの世界がサイロ化したままになっています。この記事では、開発チームと運用チーム、そしてセキュリティ、ガバナンス、ネットワーク・チームを結びつけるビジネスと文化の影響について見ていきます。そして、GitHubとHashiCorpがCI/CDパイプライン全体を通して一貫したワークフローとガードレールをどのように実現できるかを探ります。従来の運用（Ops）の世界 HashiCorpの共同創業者であるArmon Dadgar氏は、従来のOpsの世界を「木」に例えて説明しています。トランクには、物事を成し遂げるために企業で必要な、共有され一貫性のあるサービスがすべて含まれています。セキュリティ要件、Active Directory、ネットワーク構成などを考えてみてください。ブランチは、企業内のさまざまなビジネスラインを表し、社内または社外にサービスや製品を提供します。葉は、ソフトウェアやサービスが展開されるさまざまな環境と技術を表します。クラウド、オンプレミス、コンテナ環境などです。多くの企業では、これらの異なるビジネス領域間のコミュニケーション・チャネルやプロセスが煩雑で、コストがかかる場合があります。インフラやアーキテクチャに大きな変更があった場合、通常、複数のチケットが複数のチームに提出され、企業内のさまざまな部署でレビューと承認が行われます。組織を保護するために、変更諮問委員会が一般的に使用されます。通常、文書化が完了しない限り、変更を進めることはできません。一般的に、将来の監査に必要な一連のガバナンスログと監査可能な成果物が存在します。もし、チームが最適化された自動化されたワークフローを持ち、それを使って納期を早め、安全なガードレールのセットで仕事を終わらせることができるようになったら、企業にとってより有益ではないでしょうか？これは、時間とコストの大幅な節約につながり、ビジネス価値の向上につながる可能性があります。最近のForresterのレポートでは、GitHubを使うことで3年間で433%のROIを達成したという結果が出ています。もちろん、時間の節約や効率の向上は言うまでもなく、一貫性と作業の合理化によってもたらされるその他の質的なメリットもあります。あなたの製品やサービスは、遅々として進まない、手作業でエラーが起こりやすいプロセスではなく、セキュリティとガバナンスが組み込まれた最適化された経路でデプロイされることになるでしょう。これこそ、DevOps、GitOps、Cloud Nativeの夢ではないでしょうか？ IaCの導入別の例えを使いましょう。IaCは、ソフトウェアやサービスをホストするリソース（サーバー、データベース、ネットワークコンポーネント、PaaSサービスなど）の設計図だと考えてください。病院と学校を設計する場合、両シナリオで同じ全体的な設計図を使用することはないでしょう。なぜなら、両シナリオはまったく異なる目的を持ち、要件も大きく異なるからです。しかし、2つの設計にまたがって再利用できる構成要素や基礎があるはずです。 HCLのようなIaCソリューションでは、ソフトウェア開発でメソッド、モジュール、パッケージライブラリを再利用するのと同様に、これらのビルディングブロックを定義して再利用することができます。IaCであるため、アプリケーションでコラボレーションやデプロイを行う際に使用するのと同じ推奨プラクティスをインフラに採用することができます。結局のところ、DevOpsの方法論を採用するチームは、生産性、クラウド対応のスケーラビリティ、コラボレーション、およびセキュリティが向上することが分かっているのです。より良いデリバリー方法このような背景から、インフラストラクチャをコード化することで得られる具体的なメリットと、それが従来の運用文化の変革にどのように役立つかを探ってみましょう。リポジトリにコードを保存するまずは、最も低いところにある果実から始めましょう。IaCであれば、GitHubなどのソースコード・リポジトリにインフラストラクチャやアーキテクチャ・パターンを保存することができます。これにより、完全なバージョン履歴を持つ単一のソース・オブ・トゥルースを手に入れることができる。これにより、必要に応じて変更をロールバックしたり、履歴から特定のバージョンの真実をデプロイしたりすることが容易にできるようになります。企業内のチームは、Git リポジトリ内の個別のブランチでコラボレーションを行うことができます。ブランチを使うことで、チームや個人は「自分のスペース」で生産的になり、「本番」の真実のソース（通常はメインブランチ）から離れて、他のチームの進行中の作業に悪影響を与えることを心配する必要がなくなります。前節で述べた再利用可能なビルディングブロックであるTerraformモジュールも、Gitリポジトリに保存されバージョン管理されています。そこからTerraform Cloudのプライベートレジストリにインポートすることで、全チームが簡単にモジュールを発見できるようになります。GitHubで新しいリリースバージョンのタグが付けられると、レジストリにも自動的に更新されます。早期かつ頻繁にコラボレーションする上で説明したように、チームは現在の状態に影響を与えないように、別々のブランチで変更を加えることができます。しかし、その変更を本番環境のコードベースに反映させたい場合はどうすればいいのでしょうか。もしあなたが Git に慣れていないのなら、プルリクエストという言葉を聞いたことがないかもしれません。その名のとおり、あるブランチから別のブランチに変更を「引き込む」ことができます。 GitHub のプルリクエストは、チーム内の他のユーザーとコラボレーションするためのすばらしい方法です。ピアレビューを受けることで、フィードバックを自分の作業に反映させることができます。プルリクエストのプロセスは、チーム全体のコラボレーションを促進するために意図的に非常にソーシャルになっています。 GitHub では、ブランチ保護ルールを設定してメインブランチへの直接の変更を不可とすることもできます。そうすれば、すべてのユーザーがコードを実運用に移すにはプルリクエストを経由しなければならなくなります。ブランチ保護ルールには、最低限必要なレビュアーの人数を指定することもできます。ヒント:GitHub のCODEOWNERS ファイルという特殊なファイルを使えば、編集中のファイルに基づいてプルリクエストにレビュアーを自動的に追加することができます。例えば、すべてのHCLファイルは、コアインフラストラクチャチームによるレビューが必要かもしれません。あるいは、勘定系システムのIaC設定には、コンプライアンスチームによるレビューが必要かもしれません。通常、特定の周期で行われる変更諮問委員会とは異なり、プルリクエストはコードを本番環境に導入するためのプロセスの自然な一部となります。また、意思決定や議論の質も向上します。外部システムで推奨される「イエス/ノー」の決定ではなく、プルリクエストで直接コンテキストと推奨を確認することができます。プロビジョニングプロセスではコラボレーションも重要です。GitHubとTerraform Cloudの統合により、これらのプロセスを複数のチーム間でスケールさせることができます。Terraform Cloud は Terraform の状態を安全に保存し、GitHub リポジトリと直接統合することで、プルリクエストとマージのライフサイクルをターンキーで体験できるようなワークフロー機能を提供します。自動化された品質レビューをプロセスに取り入れる前節の続きですが、プルリクエストでは、提案された変更の品質を自動的にチェックすることもできます。ソフトウェアでは、アプリケーションが正しくコンパイルされているか、ユニットテストは合格しているか、セキュリティの脆弱性はないかなどをチェックするのが一般的です。 IaCの観点からは、同様の自動チェックを我々のプロセスに取り入れることができます。GitHub のステータスチェックを使えば、特定の条件を満たしているかどうかを明確に把握することができます。 GitHub Actions は、GitHub のプルリクエストでこうした自動チェックを実行するためによく使われるものです。IaCの品質を判断するために、以下のようなチェックを入れることができます。コードが構文的に正しいかどうかを検証する（例えばTerraform validate）。コードが特定の標準に従っていることを確認するためのLinting（例えば、TFLintや Terraform format）。静的コード解析により、「設計時」にインフラストラクチャの設定ミスを特定します (たとえば、tfsecやterrascan など)。関連するユニットテストまたは統合テスト（Terratest などのツールを使用）。インフラストラクチャを「スモークテスト」環境にデプロイし、インフラストラクチャの構成が（既知のパラメータセットと共に）望ましい状態にデプロイされることを検証します。 Terraform on GitHubを使い始めるのは簡単です。TerraformのバージョンはLinuxベースのGitHubでホストされたランナーにインストールされていますし、HashiCorpには公式のGitHub Actionがあり、指定したTerraformバージョンを使ってランナーにTerraformをセットアップしてくれます。

GitHub Codespacesを使った初心者向けコーディング学習ガイド

Published at February 22, 2023
Category: Community,Product,Codespaces
Author: Rizel Scarlett

Summary

新しいコードスペース GitHub Codespacesは、学んだことを応用し、新しい言語やフレームワークを習得するのに有効なツールです。

コーディングを始めたばかりの頃は、延々と続くチュートリアルをこなしていくだけで精一杯になりがちです。GitHub Codespaces では、学んだことを応用して（さらに学んで）いくことができます。パワフルなコンピューターがなくても始められるのがいいところです。

ソフトウェアエンジニアリングのキャリアにおいて、どの段階にいるかに関係なく、常に何か新しいことを学ばなければならないのです。初心者のうちは、実際に実践するよりも、コードの書き方に関するチュートリアルに多くの時間を費やすことになりがちです。「見て、やって、教える」は、新しいコンセプトを観察し、適用し、そして教えるときに効果的な学習が起こることを示唆する学習方法論です。プログラミングの概念を初めて学ぶとき、「見て、やって、教える」ことは、開発スキルを身につける上で非常に有効です。しかし、観察の段階で行き詰まる原因の1つは、応用の仕方が分からないことです。"どんなプロジェクトを作ればいいんですか？"というのは、新人開発者からよく聞かれる質問です。そして、正直なところ、私自身も同じ質問をすることがあります。

幸い、GitHub Codespacesは、学んだことを応用するのに役立つ効果的なツールです。GitHub Codespacesを使って、新しい言語やフレームワークを学ぶ方法を一緒に見つけていきましょう。

まずは GitHub にログインして、次のステップ "はじめてのコードスペース" に進みましょう。

Screenshot of GitHub's login screen.

GitHub の利用は初めてですか？

GitHub を使うのが初めてなら、歓迎します。GitHub は、開発者がコードを保存したりコラボレーションしたりするために使用するプラットフォームです。まずは GitHub.com にアクセスし、"Sign Up" をクリックして、サインアップのワークフローを完了させましょう。

最初のコードスペース

このリンクをクリックし、"Use this template" を選択すると、私があなたのために特別に作成したコードスペースに入ることができます!コードスペースが完全にロードされると、「Simple Browser」というタイトルのタブにウェブアプリのライブプレビューが表示されます（「Simple Browser」タブがまだ表示されていない場合は、ロードに数分かけます）。下の画像のように表示されるはずです。

Screenshot of GitHub Codespaces.

コーディングを開始しましょう

いくつかの単語を変更する

現在、ウェブアプリには「GitHub Codespaces React」と書かれています。以下の手順で、「GitHub Codespaces」という単語を GitHub のユーザーネームに置き換えてみましょう。

Codespaceでは、すでにApp.jsというファイルが開かれています。App.jsファイルは、すべてのコンテンツが存在する場所です。(App.js ファイルを誤って閉じてしまった場合は、"src" というフォルダーで見つけて再度開くことができます)。
App.jsファイルの9行目に、「GitHub Codespaces React」という文字が「.」で表される段落タグで囲まれているのが見えると思います。
9行目の "GitHub Codespaces" という単語を、あなたの GitHub ユーザー名に変更します。
Macの場合は「commandとs」、Windowsの場合は「controlとs」キーを押して、App.jsファイルに加えた変更を保存してください。
Simple Browserのタブで変更が反映されていることを確認します。GitHub Codespaces では、保存されたファイルの変更に気づいてブラウザを更新・再読み込みする処理を "自動的" に行っています。

私のGitHubユーザー名はblackgirlbytesなので、私のWebアプリには "blackgirlbytes React" と表示されています。

Screenshot of GitHub Codespaces.

背景色を変更する

Reactアプリの背景色は、現在グレーです。グレーは誰かの好きな色かもしれませんが、私の好きな色ではありません。以下の手順で明るくしてみましょう。

srcフォルダーにあるApp.cssファイルに移動します。これは、ウェブアプリのスタイルが保存されている場所です。
App.cssファイルの11行目に、以下のようなコードが表示されます。
background-color:#282c34;#282c34は、グレーという色の16進数コードです。
この#282c34を 紫に置き換えてみてください（私の好きな色です！）。
Macの場合は「commandとs」、Windowsの場合は「controlとs」キーを押して、App.cssファイルに変更内容を保存します。
ブラウザのタブで、変更が反映されていることを確認します。

最終的には、以下の画像のようになるはずです。

Screenshot of GitHub Codespaces.

さらにヘルプが必要ですか？

コードスペースに、ウェブアプリを変更するためのガイドツアーを用意しました。ツアーを開始するには、次の手順を実行します。

エディターの左サイドバーにある「エクスプローラーアイコン」を選択します。
エディタの左サイドバーにある "CodeTour "パネルをトグルする。
再生ボタン "を押して、ツアーを開始します。
CodeTourがスタートします。CodeTourの手順に従って、Webアプリを更新してください。

コード空間を公開する

これはすごい！という感じですね。(別の単語や色をレンダリングさせたい場合は、自由に実験してください。)私はこの作成に満足しています。将来的にこのコード空間に戻り、Webアプリの拡張を続け、他の人と共有できるようにしましょう!

GitHub のリポジトリと呼ばれるプロジェクトフォルダに、コードを保存していきます。これを行うには、以下の手順に従います。

https://github.com/codespaces に移動します。GitHub Codespaces があなたの変更を保存するので、タブやウィンドウを離れることを気にしないでください。
ページの一番下までスクロールすると、あなたが作成したコードスペースが表示されます。おかしな名前になっているかもしれません。GitHub Codespace は、コードスペースを識別するための名前を自動的に生成します。私のコードスペースは "ユビキタス・アコーン" という名前になっています。
右側の三つの点をクリックし、"Publish to new repository" というオプションを選択します。
ここで、あなたのプロジェクトにもっと識別しやすい名前をつけ、プロジェクトを公開し、"See repository" というボタンであなたのリポジトリを見ることができます。
これで、GitHub上のあなたのリポジトリにたどり着きます。プロジェクト内の様々なファイルも表示されます。リポジトリへのリンクを共有すれば、他の開発者があなたと共同作業したり、あなたのコードベースを探したりすることができます。

ボーナスチップ

あなたのコードがリポジトリに登録されたので、コードスペースを削除することができます。心配しないでください。コードスペースを削除しても、あなたのコードが失われるわけではありません。あなたのコードは常にリポジトリに存在し、あなたとコラボレーションしたい人、あなたから学びたい人と共有することができます。

コードスペースでコードを再開したい場合は、リポジトリで「コード」ボタンを選び、コードスペースタブの「+」をクリックしてください。

Screenshot showing how to open a GitHub Codespace.

クイックスタート・テンプレートをチェックする

クイックスタート・テンプレートには、Next.js, React.js, Django, Express, Ruby on Rails, Preact, Flask, Jupyter Notebook など、最も一般的なアプリケーションフレームワークの定型的なコードが含まれています。これらのテンプレートは、開発者に、コードスペースでアプリケーションを構築、テスト、デバッグするためのサンドボックスを提供します。つまり、ゼロからコーディングを始める必要はありません。すでに動作しているプロジェクトがあるので、それを拡張して、あなたが思い描いているプロジェクトにすることができます。開発者がさまざまなプログラミング言語で書かれたプロジェクトをどのように構成しているかを理解するために、テンプレートを使用することができます。また、さまざまなファイルが互いにどのように通信しているかを理解するためにも使えます。

例えば、私はずっと人工知能（AI）と機械学習について学びたいと思っていましたが、どこから手をつけていいのか全く分かりませんでした。私は、Jupyter Notebooksのテンプレートを使って、AI画像を生成してみました。このテンプレートには、私が必要とするすべてのツールがすでに備わっていました。私は数行のコードを変更するだけでよかったのです。

Screenshot showing Codespaces templates.

次はどうする？

おめでとうございます、あなたはプログラミングの知識をレベルアップしました。これからも GitHub Codespaces でさまざまなフレームワークを試してみたり新しい言語を学んだりすることができます。Preact、Jupyter Notebook、Flask、Django、Express、Ruby on Rails、Node などでプロジェクトを立ち上げたり新しいフレームワーク言語を学習したりしたい場合は、他のテンプレートもチェックしてみてください。

GitHub Codespaces のより高度な概念に興味がある方は、ドキュメントをご覧ください。

プロジェクトと GitHub Codespaces をセットアップしたら、ハッシュタグ#ShareYourCodespace をつけてソーシャルメディアでシェアしましょう！（英語）。

Source

A beginner’s guide to learning to code with GitHub Codespaces

It doesn’t matter what stage you’re at in your software engineering career, there’s always something new to learn. As a beginner, it’s so easy to spend more time-consuming tutorials on how to code rather than actually putting it into practice. “See one, do one, teach one” is a learning methodology …

GitHub Blog | 非公式日本語

すべての公開リポジトリでシークレットスキャンアラートが無料で利用可能になりました！

意外と知らない、GitHub Codespacesでできる10のこと！

開発チームと運用チームの一貫したワークフローを構築する方法

アジリティを低下させることなく、コンプライアンスのニーズに応える3つの方法

新しいデータセットでオープンソースに関する政府の政策を測定する