Python: 開発プラットフォーム

スムーズで生産的な開発体験のために開発プラットフォームを準備しましょう

👋 Stackhero ドキュメントへようこそ！

Stackhero は、デプロイ作業を効率化するために設計された、すぐに使える Python クラウドソリューションを提供しています：

シンプルな git push だけで、数秒でアプリケーションを本番環境にデプロイできます。

ご自身のドメイン名を利用可能で、HTTPS 証明書の自動設定により安全な接続も自動で管理されます。

自動バックアップ、ワンクリックアップデート、予測可能な料金体系により、インフラ管理ではなくコードに集中できます。

プライベートかつ専用インフラ上で、強力なパフォーマンスとセキュリティを実現。お客様の環境は分離され、保護されています。

時間を節約し、ワークフローをシンプルに：Stackhero の Python クラウドホスティングなら、わずか 5分でコードを稼働させることができます。

適切に準備された開発プラットフォームは、ワークフローをよりスムーズかつ生産的にします。

このガイドでは、Python 開発のための 2 つの効果的な方法、すぐにコーディング可能なリモート環境を利用する方法と、ご自身のコンピュータ上にローカル環境を構築する方法について説明します。また、asdf を使った Python のインストール方法や、ゼロから新しい Python プロジェクトを作成する手順もご紹介します。

開発方法：ローカルかリモートか

Python 開発には主に 2 つのアプローチがあります。すべてをご自身のデバイス上で実行する方法と、Code-Hero のようなクラウドベースのワークスペースを活用する方法です。それぞれに明確なメリットがありますので、ご自身のワークフローや要件に最適な方法をお選びください。

ローカル開発 では、完全にオフラインで作業できます。インターネット接続が制限されている場合や、ネットワークの中断なく開発したい場合に有効です。ただし、環境のセットアップには追加の時間がかかり、アップデートやバックアップ、システムメンテナンスもご自身で管理する必要があります。また、作業は現在のデバイスに限定されるため、柔軟性やパフォーマンスに制約が生じる場合があります。

リモート開発 を Code-Hero のようなプラットフォームで行う場合、すぐに使える環境が提供されます。各種ツールが事前にインストールされており、使い慣れたインターフェースとクラウドリソースを利用できるため、ローカルハードウェアよりも高いパフォーマンスを得られることが多いです。インターネット接続さえあればどのデバイスからでも作業でき、ワークスペースは常にバックアップされ安全です。

Docker や Traefik などの高度な機能もすでにセットアップされており、開発環境で実際のドメインや HTTPS を利用できます。これにより、Webhook の利用や CORS ポリシーのテスト、本番環境に近い条件のシミュレーションも数秒で行え、手動設定は不要です。

比較のため、以下にまとめます：

ローカル開発（ご自身のコンピュータ上）:
- ✅ 完全オフラインアクセス：インターネット接続不要
- ❌ リソース制限：デバイスのハードウェア性能に依存
- ❌ 手動セットアップ：すべてご自身でインストール・設定
- ❌ 継続的なメンテナンス：アップデートやバックアップも自己管理
リモート開発（Code-Hero 上）:
- ✅ 即時環境：すぐに開発開始、ツールは事前インストール済み
- ✅ スケーラブルなリソース：高性能サーバーを利用可能
- ✅ どこからでも作業可能：あらゆるデバイス・場所に対応
- ✅ 本番環境に近いテスト：実際の HTTPS ドメインや各種連携がすぐに利用可能
- ❌ インターネット必須：常時接続が必要

どちらを選ぶかは、ご自身のニーズや好みによります。最小限のセットアップですぐに開発を始めたい、デバイスを切り替えて柔軟に作業したい場合はリモート環境が理想的です。オフライン作業を重視する場合や、特定のローカル要件がある場合はローカル環境が適しています。

Python 開発：リモートアプローチ

Python 開発にリモート環境を選択することで、手動セットアップの手間を省けます。必要なツールがすべて揃った状態で、数秒で新しいプロジェクトを開始できます。

Code-Hero では、開発ワークスペースが高性能サーバー上で稼働するため、負荷の高いプロジェクトでもスムーズかつ快適に作業できます。依存関係や環境設定に時間を取られることなく、コーディングや機能開発に集中できます。

Code-Hero サービスが稼働したら、すぐにPython プロジェクトの作成に進めます。以下のローカルセットアップ手順は不要です。

Python 開発：ローカルアプローチ

Python をローカルでセットアップする場合、ご自身のマシンにランタイムや依存パッケージ、開発ツールをインストールします。これにより完全なコントロールが得られますが、アップデートやバックアップ、環境の一貫性維持もご自身の責任となります。

ローカル Python 環境のセットアップ

柔軟かつ一貫性のある環境構築には、複数のランタイムバージョンを管理できる asdf の利用がおすすめです。asdf は Python だけでなく、Node.js、Ruby、PHP など多くの言語に対応しており、バージョンの切り替えやプロジェクトごとの分離も簡単です。

従来の Python ワークフローでは、python venv、virtualenv、mkvirtualenv などの仮想環境を使って依存関係を分離しますが、asdf を使えば Python バージョンとプロジェクト環境の両方をより堅牢に管理でき、バージョン競合などのトラブルも回避しやすくなります。

asdf のインストール

公式 asdf インストールガイドに従って、ご自身のシステムに asdf をセットアップしてください。

インストール後、以下のコマンドで asdf が正しくセットアップされているか確認します：

asdf version

インストール済みのバージョンが表示されれば、asdf の準備は完了です。

asdf を使った Python のインストール

Python サポートを追加し、最新版をインストールするには以下を実行します：

asdf plugin add python https://github.com/danhper/asdf-python.git
asdf install python latest
asdf global python latest

完了したら、Python のバージョンを確認します：

python --version

この出力が表示されれば、Python のインストールは開発準備が整っています。

Python プロジェクトの作成

新しい Python プロジェクトは、以下の手順で開始できます：

mkdir my_project
cd my_project

このプロジェクト用の Python バージョンを設定し、Git リポジトリを初期化するには：

asdf install python latest \
  && asdf local python latest

echo "__pycache__/" >> .gitignore

git init
git add -A .
git commit -m "First commit"

これらのコマンドで新しいディレクトリが作成され、プロジェクト用の Python バージョンが設定され、バージョン管理が初期コミットとともに開始されます。すぐに開発を始められます。

お使いの Python プロジェクトにはローカル Git リポジトリが初期化されていますが、まだリモートホスティングサービスには接続されていません。

信頼性の高いバックアップやチームでの共同作業のために、GitLab、GitHub、Bitbucket などのプラットフォームでリポジトリを作成できます。

専用かつセキュアな Git ホスティングソリューションが必要な場合は、Stackhero がヨーロッパまたは USA のプライベートインフラ上で稼働する GitLab クラウドサービスを提供しています。迅速なセットアップとコードの機密性を確保できるオプションです。