このチュートリアルでは、 Cloud de Confiance by S3NSで動作する Python アプリの開発など、Python 開発用にローカルマシンを準備する方法を説明します。
開発環境がすでに設定されている場合は、Python と Cloud de Confianceで、 Cloud de Confianceで Python アプリを実行する方法の概要を確認してください。
目標
- Cloud de Confianceと互換性のあるサポートされているバージョンの Python をインストールします。
venvを使用して依存関係を隔離します。- エディタのインストール(省略可)
- Google Cloud CLI をインストールします(省略可)。
- Python 用の Cloud クライアント ライブラリのインストール(省略可)
- その他の便利なツールをインストールします。
- 認証を設定します(省略可)。
Python をインストールする
Python のインストール手順は、オペレーティング システムによって異なります。開発環境で実行しているオペレーティング システム(macOS、Windows、Linux)のガイドに従ってください。
macOS
macOS にはデフォルトで Python のバージョンが含まれており、独自の目的に使用されています。macOS との干渉を避けるため、別の開発環境を作成し、 Cloud de Confiance用にサポートされているバージョンの Python をインストールすることをおすすめします。Python をインストールするには、homebrew を使用します。
Homebrew を使用して Python パッケージをインストールするには、Xcode のコマンドライン ツールをインストールしてコンパイラを入手する必要があります。
xcode-select --installHomebrew のホームページの手順に従って Homebrew をインストールし、Homebrew を使用して以下のとおり Python をインストールします。
brew install pyenv pyenv install PYTHON_VERSIONPython のバージョン番号は
x.yの形式にする必要があります。次に例を示します。pyenv install 3.12インストールが完了したら、Python 3 が
pythonおよびpython3として使用可能であること、pipもインストールされていることを確認します。Python が利用可能であることを確認するには、次のコマンドを実行します。
python3 --versionバージョンが出力されます。 Python homebrew については、Homebrew Python Formula のページをご覧ください。その後、バージョンを確認します。
pip3が利用可能であることを確認するには、次のコマンドを実行します。pip3 --versionインストールされている場合は、
pip3のバージョンが出力に表示されます。pip3の最新バージョンについて詳しくは、pipリリースノートをご覧ください。上記のコマンドで
pip3バージョンが表示されない場合は、pip3が正しくインストールされていることを確認してください。pip3がインストールされているが動作しない場合は、次のコマンドを使用して最新バージョンにアップグレードします。python -m pip install --upgrade pipHomebrew は、プラットフォームで利用可能な最新バージョンの Python をインストールします。出力のバージョン番号は、Python の最新の公式リリースと異なる場合があります。
Windows
Windows 環境に Python をインストールするには、必要なバージョンの Python のインストーラを Python のウェブサイトからダウンロードします。詳細については、 Cloud de Confianceのサポートされている Python のバージョンをご覧ください。
お使いのバージョンの Python にアクセスするには、Windows 用 Python ランチャーを使用します。
インストールした Python のバージョンを起動するには、次のコマンドを実行します。
pyインストールした Python 3 のバージョンを起動するには、次のコマンドを実行します。
py -3利用可能な
pipのバージョンを確認するには、次のコマンドを実行します。py -m pip --version出力に
C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packagesからのバージョンが表示されます。pipの最新バージョンについては、pipのリリースノートをご覧ください。
Linux
ほとんどの Linux ディストリビューションには、最新バージョンの Python が含まれています。
Python を Linux 環境にインストールするには、ご使用のディストリビューションに適したパッケージをインストールしてください。Debian と Ubuntu の場合、これらのパッケージは python3、python3-dev、python3-venv、python3-pip です。
次のコマンドを使用してこれらのパッケージをインストールします。
sudo apt update sudo apt install python3 python3-dev python3-venv python3-pipインストールが完了したら、
pipがインストールされていることを確認します。pip3 --versionpipの最新バージョンについては、pip のリリースノートをご覧ください。
venv を使用して依存関係を隔離する
venv は、分離された Python 環境を作成するツールです。これらの分離された環境には、Python パッケージの異なるバージョンを含めることができます。これにより、1 つのプロジェクトの依存関係を他のプロジェクトの依存関係から分離できます。Python を使用してローカルに開発する場合は、常にプロジェクトごとに仮想環境を使用することをおすすめします。
venvコマンドを使用して、Python インストール全体の仮想コピーを作成します。このチュートリアルでは、envという名前のフォルダに仮想コピーを作成しますが、フォルダには任意の名前を指定できます。macOS
cd your-project python -m venv envWindows
cd your-project py -m venv envLinux
cd your-project python3 -m venv env仮想環境を有効にして、Python の
venvパスを使用するようにシェルを設定します。macOS
source env/bin/activateWindows
.\env\Scripts\activateLinux
source env/bin/activateこれで、他のプロジェクトやグローバル Python インストールに影響を与えることなく、パッケージをインストールできます。
pip install google-cloud-storage仮想環境の使用をやめてグローバル Python に戻る場合は、無効化できます。
deactivate
venv の詳細については、venv のドキュメントをご覧ください。
エディタのインストール
Python アプリの開発にはエディタが必要です。よく使用されるエディタには次のものがあります(順不同)。
- Microsoft の Visual Studio Code
- Sublime Text by Jon Skinner
- JetBrains の PyCharm
Python 用 Cloud クライアント ライブラリをインストールする
Python 用 Cloud クライアント ライブラリは、Python デベロッパーが Datastore や Cloud Storage などの Cloud de Confiance サービスと統合する方法です。Cloud Storage などの個々の API のパッケージをインストールするには、次のようなコマンドを使用します。
pip install --upgrade google-cloud-storage
gcloud CLI のインストール
gcloud CLI は、 Cloud de Confiance用の一連のコマンドライン ツールです。このセットには gcloud と bq が含まれており、Compute Engine、Cloud Storage、BigQuery などのプロダクトやサービスにコマンドラインからアクセスできます。これらのツールはインタラクティブに実行することも、自動スクリプトで実行することもできます。
認証を設定する
クライアント ライブラリを使用するには、まず認証を設定する必要があります。
ユーザー アカウントのローカル認証情報を作成します。
gcloud auth application-default login
認証エラーが返された場合は、 フェデレーション ID を使用して gcloud CLI にログインしていることを確認します。
詳細については、クライアント ライブラリを使用して認証するをご覧ください。
次のステップ
Cloud de Confianceでの Python の詳細を確認する。
Google での認証方法について理解する。