ブラウザーで最初のページを見る
約 5 分で読めます
Rust のコードを読む前に、Senu を起動してブラウザーでそのページを開きます。いま読んでいるのと同じサイトが、あなたのコンピューターから配信されます。
Senu を起動する
使うコマンドは cargo run --quiet -- site です。cargo run は、まずプログラムをビルドし (Rust のソースファイルを、コンピューターが実行できるプログラムに変換すること)、それから実行します。--quiet は Cargo の進み具合の表示を隠します。-- より後ろは Senu 自身に渡され、site はこの記事を配信するよう Senu に指示します。ターミナルで、senu フォルダーの中にいる状態で、これを入力して Enter キーを押してください。
cargo run --quiet -- site
最初のビルドでは Senu と、Senu が使うものすべてをコンパイルするので、数分のあいだ何も表示されないことがあります。そのまま待ってください。準備ができると、Senu は 1 行だけ表示します。
senu: listening on http://127.0.0.1:3000
プロンプトは戻ってきません。Senu はいまサーバー、つまり動き続けてリクエストに答えるプログラムになっているからです。このターミナルは開いたままにしておいてください。
ページを開く
ブラウザーに切り替え、アドレスバーに http://127.0.0.1:3000/ja/ と入力して Enter キーを押してください。章の一覧が載った、この講座の最初のページが表示されるはずです。
アドレスは三つの部分からできています。http:// はブラウザーがサーバーと話す方法です。127.0.0.1 は「このコンピューター」を表すローカルアドレスで、インターネット上のほかの人は開けません。3000 はポートで、コンピューターの中で動いているどのプログラムにリクエストを渡すかを示す番号です。Senu が動いているあいだ、これらのページはあなただけのものです。
止めて、もう一度起動する
ターミナルに戻って Ctrl+C を押してください。Senu が止まり、プロンプトが戻ります。ブラウザーでページを再読み込みすると、もうそのアドレスに答えるものがないので、接続できないと表示されます。
同じコマンドで Senu をもう一度起動してください。前回のビルドから何も変わっていないので、今度は数秒で起動します。
cargo run --quiet -- site
senu: listening on http://127.0.0.1:3000
ブラウザーでページを再読み込みすると、元に戻ります。
二つ目のターミナルから尋ねる
サーバーにページを頼めるのはブラウザーだけではありません。Senu を一つ目のターミナルで動かしたまま、二つ目のターミナル (新しいウィンドウか、同じウィンドウの新しいタブ) を開き、cd ~/senu と入力してください。次のコマンドは二つのプログラムを使います。curl はページを取ってきて、その HTML (ブラウザーがページを描くもとになるテキスト) を表示します。-s は curl の進み具合の表示を隠します。| 記号はその出力を grep に渡し、grep はページの見出しを囲むタグ <h1> を含む行だけを表示します。次を実行してください。
curl -s http://127.0.0.1:3000/ja/ | grep "<h1>"
スタートページの見出しが表示されます。
<h1>Senu: Rust の関数ひとつを Web ページ・JSON API・MCP ツールに</h1>
この講座では、各手順の結果をこの二つ目のターミナルで文字として確かめます。いつでも代わりにブラウザーで同じページを見てかまいません。
演習
ページ上部にある、英語に切り替えるリンクを見つけてたどってください。英語の最初のページのアドレスは何でしょう。どうやって戻りますか。
解答. リンクは English と書かれていて、http://127.0.0.1:3000/ に移ります。英語のページの同じ場所にある 日本語 というリンクで戻れます。両方の言語にある記事は、どれもそこから翻訳にリンクしています。
うまくいかないとき
- 「could not find
Cargo.toml」: ターミナルがsenuフォルダーにいません。pwdを実行してからcd ~/senuを実行してください。 - 「senu: cannot listen on 127.0.0.1:3000: address in use」: Senu かほかのプログラムがポート 3000 を使っています。Senu が動いているターミナルを探して Ctrl+C を押してください。ほかのプログラムが使っている場合は、別のポートで起動します。コマンドの前に
NAME=valueと書くと、そのコマンドのときだけ設定NAMEが決まります。=の前後に空白は入れません。SENU_BINDは Senu が使うアドレスとポートを決める設定です。SENU_BIND=127.0.0.1:3001 cargo run --quiet -- siteを実行し、代わりに http://127.0.0.1:3001/ja/ を開いてください。 - ブラウザーが接続できない: Senu が動いていません。Senu のターミナルを見て、プロンプトが戻っていたらもう一度起動してください。
- 最初のビルドで**「linker
ccnot found」**などのエラーが出た: インストールの章に戻ってください。
次へ: 最初のノートを書く