MENU

Pythonで作ったものを公開する。GitHubの使い方入門

※写真はイメージです。実物とは異なる場合があります。

  • URLをコピーしました!

Pythonを学んで、自分なりにプログラムを書き、小さなツールやWebアプリが完成したとき。「これを自分のPCの中だけで終わらせず、誰かに見てもらいたい」「ポートフォリオとして公開したい」と思うのは、学習者としてとても自然なステップです。

しかし、いざ「公開」しようとすると、そこで立ちはだかるのが「GitHub(ギットハブ)」という言葉や、環境構築という高いハードルではないでしょうか。

この記事では、Pythonで作成したものを公開するために欠かせないGitHubの使い方を、初心者の方に向けて噛み砕いて解説します。Gitというツールの本質的な役割から、具体的な公開手順まで、一緒に見ていきましょう。

目次

そもそもGitとGitHubとは何が違うのか?

よく混同されがちなのが「Git」と「GitHub」です。結論から言うと、この二つは全く別のものです。

Gitは「手元の記録係(バージョン管理システム)」

Gitは、自分のPCの中で動作する「バージョン管理システム」です。 例えば、レポートや資料を作成しているときに、「ファイル名_v1」「ファイル名_v2_最終版」「ファイル名_v3_本当に最終版」というように、ファイルが増殖してしまった経験はないでしょうか。

Gitを使えば、このようなファイルの量産をしなくて済みます。ファイルの変更履歴をスマートに記録してくれるため、「いつ、誰が、どこを、どのように変更したか」が一目で分かります。また、プログラミングをしていると「コードを書き換えたら、なぜか動かなくなった」ということが日常茶飯事です。そんなとき、Gitがあれば「正常に動いていたあの時の状態」に簡単に戻すことができます。

GitHubは「コードの保管庫兼、お披露目会場」

一方でGitHubは、Gitで管理しているコードをインターネット上に保存し、共有するためのクラウドサービスです。 自分のPC(ローカル)にあるコードをGitHub(リモート)にアップロードすることで、世界中の人があなたのコードを見られるようになります。また、複数の開発者が共同で一つのプロジェクトに取り組む際にも、GitHubが中心的な役割を果たします。

GitHubを使い始めるための導入手順

まずは、コードをアップロードするための準備を整えましょう。

1. GitHubアカウントの作成

まずはGitHubの公式サイトからアカウントを作成します。メールアドレスなどの基本情報を登録し、自分だけのユーザー名を決めましょう。

2. Gitのインストール(Windowsの場合)

GitHubにコードを送るためには、自分のPCにGitがインストールされている必要があります。Windowsユーザーの方は、「Git for Windows」という公式ツールをインストールしましょう。

インストールを進める際は、多くの選択肢(コンポーネント設定)が出てきますが、特にこだわりがなければ基本的に「Next」で進めて問題ありません。ただし、以下の点に注目してみても良いかもしれません。

  • Windows Terminalの連携: 普段からWindows Terminalを使っている場合は、チェックを入れておくとGit Bashを簡単に起動できるようになり便利です。
  • デスクトップショートカット: Git BashやGit GUIのショートカットを作成しておけば、すぐに操作を開始できます。

Pythonで作ったものをGitHubで公開する流れ

環境が整ったら、実際に自分のプログラムを公開してみましょう。

リポジトリを作成する

GitHubでは、プロジェクトごとの保存場所を「リポジトリ」と呼びます。 まずはGitHub上で「New repository」から新しいリポジトリを作成してください。リポジトリ名(プロジェクト名)を決め、公開設定を「Public(公開)」にすることで、世界中の人が閲覧できる状態になります。

コードをアップロード(Push)する

自分のPCにあるPythonファイルを、作成したリポジトリにアップロードすることを「Push(プッシュ)」と言います。 Gitのコマンド操作に慣れていない初心者の場合は、GitHubのWeb画面からファイルを直接アップロードする方法もありますが、慣れてきたらGit Bashなどのツールを使って、変更履歴を管理しながらPushする習慣をつけるのがおすすめです。

Webページとして公開したい場合は「GitHub Pages」を活用

プログラムの「コード」を公開するだけでなく、実際に動作する「Webページ」として公開したい場合があります。そんな時に便利なのが「GitHub Pages」というサービスです。

GitHub Pagesとは?

GitHub Pagesは、GitHubのリポジトリにあるファイルを、そのままWebサイトとして公開できる無料のホスティングサービスです。特別なサーバーを契約することなく、`http:[ユーザー名].github.io/[リポジトリ名]` という形式のURLでサイトを公開できます。

利用する際の重要な注意点

ここで、Python学習者が特に注意しなければならない点があります。GitHub Pagesで公開できるのは「静的なページ(HTML, CSS, JavaScript)」のみであるということです。

  • サポートされないもの: Python、Ruby、PHPなどのサーバーサイド言語はサポートされていません。
  • つまりどういうことか: Pythonで書いたプログラムをサーバー上で動かし、その結果をリアルタイムで表示させるような「動的なWebアプリ」をそのまま動かすことはできません。

もしPythonでWebサイトを作りたい場合は、Pelicanのような「静的サイトジェネレーター」を使用して、あらかじめHTMLファイルを生成してからGitHub Pagesにアップロードするという手法が考えられます。

GitHub Pagesの使用制限

無料で便利なサービスですが、いくつか制限があることも覚えておきましょう。

  • リポジトリのサイズ: ソースリポジトリには1GBの上限が推奨されており、公開されたサイト自体も1GBを超えてはいけません。
  • 帯域幅制限: 月当たり100GBのソフトな帯域幅制限があります。
  • ビルド回数: 1時間あたり10回のビルド制限があります(カスタムGitHub Actionsを使用する場合を除く)。

個人でポートフォリオを公開したり、小さなツールを公開したりする分には十分な容量ですが、商用利用や大規模なアクセスが見込まれるサイトには向いていないと言えます。

公開した後の運用とメンテナンス

一度公開して終わりではなく、コードを改善し続けることが上達への近道です。

修正して再度公開する

プログラムを修正したら、再びGitで変更を記録し、GitHubにPushします。GitHub Pagesを使用している場合は、ブランチ(開発の枝分かれ)にPushすることで、Webサイトの内容も自動的に更新される仕組みになっています。

コード公開のリスクを考える

GitHubで「Public」に設定して公開するということは、世界中の誰でもあなたのコードが見られる状態になるということです。 ここで絶対にやってはいけないのが、「APIキー」や「パスワード」などの機密情報をコードに書き込んだまま公開することです。これらが流出すると、不正利用される危険があります。機密情報は別ファイルに分けるか、環境変数を利用して管理し、GitHubにはアップロードしないように注意しましょう。

まとめ

Pythonで作成したものを公開することは、単に「見せる」だけでなく、自分の成長を記録し、他のエンジニアからフィードバックをもらう貴重な機会になります。

  1. Gitで自分のPC内の変更履歴を管理する。
  2. GitHubのリポジトリにコードをPushして世界に公開する。
  3. 静的なWebページとして見せたいならGitHub Pagesを活用する。

まずは小さなスクリプトからで構いません。GitHubという世界最大のコード保管庫に、あなたの挑戦の記録を残してみてください。一歩ずつ操作に慣れていけば、バージョン管理の便利さと、公開することの楽しさが分かるはずです。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次