Serverless Devs は、Function Compute アプリケーションの開発およびデプロイを行うためのコマンドラインツールです。本ページでは、macOS、Linux、Windows 各環境への Serverless Devs のインストール手順、インストールの確認方法、およびローカルデバッグ用に Docker を任意でインストールする方法について説明します。
Serverless Devs のインストール
前提条件
開始する前に、以下の条件を満たしていることをご確認ください。
対応するオペレーティングシステム:macOS、Linux、または Windows
(npm および Yarn を使用する場合に必須) Node.js バージョン 10 以降 — 現在のバージョンを確認するには、
node --versionを実行します。
インストール方法
お使いのシステムで利用可能なツールに応じて、以下のいずれかの方法を選択してください。
npm を使用(Windows、macOS、Linux)
以下のコマンドを実行します。
sudo npm install @serverless-devs/s -g注: Node.js バージョン 10 以降が必要です。現在のバージョンを確認するには、node --version を実行します。Yarn を使用(Windows、macOS、Linux)
以下のコマンドを実行します。
sudo yarn global add @serverless-devs/sインストールスクリプトを使用(macOS および Linux)
以下のコマンドを実行します。
curl -o- -L http://cli.serverless-devs.com/install.sh | bashインストールが完了したら、画面の指示に従って環境変数を設定してください。設定を行わないと、インストールが即座に有効になりません。詳細については、後述の「トラブルシューティング」セクションをご参照ください。
インストールの確認
以下のコマンドを実行し、Serverless Devs が正しくインストールされたことを確認します。
s -v期待される出力例:
@serverless-devs/s: 2.0.83, linux-x64, node-v14.17.4s コマンドが見つからない場合は、後述の「トラブルシューティング」セクションをご参照ください。
Docker のインストール
s local(ローカルデバッグ)または s build --use-docker(Docker を使用した依存関係のインストールまたはプロジェクトビルド)を実行する場合にのみ、Docker のインストールが必要です。これらのコマンドを使用しない場合は、本セクションをスキップしてください。
Docker が必要な場合、Serverless Devs は自動的に Docker コンテナを作成・管理します。
ご利用のオペレーティングシステム向け Docker をダウンロードしてください。
Windows:Docker Desktop for Windows。ネットワーク接続に問題がある場合は、Alibaba Cloud 鏡像(Windows 版) をご利用ください。
macOS:Docker Desktop for macOS。ネットワーク接続に問題がある場合は、Docker Desktop for Mac インストールページをご参照ください。
Linux:Ubuntu 向け Docker Engine インストールガイドに従ってインストールしてください。ネットワーク接続に問題がある場合は、Alibaba Cloud Docker コミュニティエディション鏡像 をご利用ください。
トラブルシューティング
ダウンロード速度が遅い
ダウンロード速度を向上させるために、Alibaba Cloud npm 鏡像レジストリをご利用ください。
npm --registry=https://registry.npmmirror.com install @serverless-devs/s -gs -v を実行してもアップグレード後のバージョンが表示されない
元のインストールコマンドと同じアップグレードコマンドを再度実行し、以下のいずれかの対応を行ってください。
新しいバイナリへのパスを手動でエクスポートします。
export PATH=$HOME/.s/node-v14.19.3-linux-x64/bin:$PATH注:
node-v14.19.3の部分は、お使いのシステムにインストールされている Node.js のバージョンに置き換えてください。バージョンはオペレーティングシステムによって異なります。新しいターミナルウィンドウを開き、再度
s -vを実行します。
コマンドが見つかりません を Linux または macOS で s を実行したときに表示される
s コマンドを PATH から利用可能にするために、シンボリックリンクを作成します。
npm またはインストールスクリプトでインストールした場合:
ln -s $(npm root -g)/@serverless-devs/s/bin/s /usr/local/bin/sYarn でインストールした場合:
ln -s $(yarn global dir)/node_modules/@serverless-devs/s /usr/local/bin/
Serverless Devs のアップグレード
元のインストールコマンドを再度実行してください。パッケージマネージャにより、既存のバージョンが上書きされます。