بتل کد Battle Codeدارد باز می‌شود…

سرور و اتصال

کد روی کامپیوتر تو نوشته می‌شود ولی روی سروری دوردست اجرا می‌شود. این درس کلمه‌های پل بین این دوست: وصل شدن، فرستادن پورت‌ها، فایل تنظیمات و برنامه‌هایی که بی‌صدا پشت صحنه کار می‌کنند.

local و remote: دو صفت متضاد

local یعنی «همین‌جا، روی کامپیوتر خودم» و remote یعنی «دور، روی کامپیوتر دیگر». در متن‌های فنی زیاد با هم می‌آیند: local branch و remote branch، local file و remote file. حرف اضافه‌ها را هم ببین: on your local machine، on the remote server، و برای وصل شدن into: «SSH into the server».

هشت کلمه‌ی این درس

feature flag (فیچِر فلَگ): کلید روشن و خاموش یک ویژگی، بدون deploy دوباره

feature یعنی ویژگی و flag یعنی پرچم یا نشانه‌ی روشن و خاموش. feature flag یک تنظیم است که می‌گوید یک ویژگی برای چه کسانی روشن باشد. کد ویژگی تازه از قبل روی سرور است ولی پشت یک if پنهان مانده؛ می‌توانی آن را اول فقط برای تیم خودت، بعد ۱۰ درصد کاربرها و بعد همه روشن کنی، و اگر مشکلی پیش آمد در یک لحظه خاموشش کنی. مثل کلید برق که سیم‌کشی‌اش از قبل انجام شده.

The new editor is behind a feature flag until we finish testing.

ویرایشگر تازه تا وقتی تست‌ها تمام شود پشت یک feature flag است.

config file (کانفیگ فایل): فایل تنظیمات؛ فایلی که رفتار برنامه را بدون عوض کردن کد تعیین می‌کند

config کوتاه‌شده‌ی configuration یعنی پیکربندی، چیدمان و تنظیم اجزا. config file فایلی است که تنظیمات برنامه را جدا از کد نگه می‌دارد: نشانی پایگاه داده، پورت، زبان پیش‌فرض، روشن یا خاموش بودن حالت debug. این‌طور همان کد را می‌شود روی کامپیوتر خودت، سرور آزمایشی و سرور واقعی با تنظیم‌های متفاوت اجرا کرد. قالب‌های رایجش JSON، YAML، TOML و ‎.env هستند.

Change the port in the config file, not in the code.

پورت را در فایل تنظیمات عوض کن، نه در کد.

local machine (لوکِل مِشین): کامپیوتر خودت؛ دستگاهی که پشتش نشسته‌ای

local یعنی محلی، همین‌جا و نزدیک، و machine این‌جا یعنی کامپیوتر. local machine همان کامپیوتری است که جلوی تو است و رویش کد می‌نویسی، در برابر سروری که جای دیگری است. در راهنماها می‌خوانی «on your local machine» یعنی این دستور را روی کامپیوتر خودت اجرا کن، نه روی سرور. محیطی که در آن کار می‌کنی را هم local environment می‌گویند.

Clone the repository to your local machine and run the tests.

مخزن را روی کامپیوتر خودت clone کن و تست‌ها را اجرا کن.

remote server (ریموت سِروِر): سرور دوردست؛ کامپیوتری در جای دیگر که از راه شبکه به آن وصل می‌شوی

remote یعنی دور، مثل remote control یعنی کنترل از راه دور. remote server کامپیوتری است که جای دیگری است، مثلا در یک دیتاسنتر در شهر یا کشور دیگر، و تو از راه اینترنت به آن وصل می‌شوی، دستور می‌فرستی و فایل جابه‌جا می‌کنی. معمولا صفحه‌کلید و مانیتوری ندارد و فقط از راه ترمینال (مثلا با SSH) با آن کار می‌کنی. سایت تو روی همین سرورها اجرا می‌شود.

Copy the build folder to the remote server with scp.

پوشه‌ی build را با scp به سرور دوردست کپی کن.

SSH (اِس‌اِس‌اِیچ): راه امن وصل شدن به ترمینال یک کامپیوتر دیگر

SSH یعنی «پوسته‌ی امن»: راهی رمزنگاری‌شده برای این‌که از ترمینال خودت به ترمینال یک کامپیوتر دیگر وصل شوی و آن‌جا دستور اجرا کنی، انگار پشت همان کامپیوتر نشسته‌ای. چون همه‌چیز رمز می‌شود، کسی در میانه‌ی راه نمی‌تواند رمز عبور یا دستورهایت را بخواند. به جای رمز عبور معمولا از یک جفت کلید (SSH key) استفاده می‌کنند که امن‌تر است. GitHub هم برای push از SSH پشتیبانی می‌کند.

SSH into the server and check the disk space.

با SSH به سرور وصل شو و فضای دیسک را بررسی کن.

port forwarding (پورت فورواردینگ): فرستادن ترافیک یک پورت به پورتی در کامپیوتر دیگر

forward یعنی جلو فرستادن، مثل forward کردن یک پیام برای کس دیگر. port forwarding یعنی هر چه به یک پورت رسید، به یک پورت دیگر، معمولا روی کامپیوتر دیگری، فرستاده شود. مثلا پایگاه داده‌ی سرور فقط از درون خود سرور قابل دیدن است؛ با port forwarding از راه SSH، پورت ۵۴۳۲ کامپیوتر خودت را به آن وصل می‌کنی و انگار پایگاه داده روی کامپیوتر خودت است. روترهای خانگی هم port forwarding دارند.

Use SSH port forwarding to open the admin panel safely from home.

از port forwarding با SSH استفاده کن تا پنل مدیریت را از خانه امن باز کنی.

reverse proxy (ریوِرس پراکسی): سروری جلوی سرورهای دیگر که درخواست‌ها را به آن‌ها می‌رساند

proxy یعنی نماینده یا وکیل، کسی که به جای تو کاری را انجام می‌دهد. proxy معمولی نماینده‌ی کاربر است، ولی reverse proxy برعکس، نماینده‌ی سرورهاست: جلوی آن‌ها می‌ایستد، همه‌ی درخواست‌ها را می‌گیرد و هر کدام را به سرور درست می‌فرستد. مثل منشی پذیرش یک شرکت که مراجعه‌کننده‌ها را به اتاق درست راهنمایی می‌کند. معمولا HTTPS، فشرده‌سازی و cache را هم همین‌جا انجام می‌دهند. Nginx و Caddy معروف‌اند.

Nginx works as a reverse proxy in front of our Python app.

Nginx مثل یک reverse proxy جلوی برنامه‌ی پایتونی ما کار می‌کند.

daemon (دیمِن): برنامه‌ای که بی‌صدا در پس‌زمینه همیشه روشن است

daemon در افسانه‌های یونانی روحی یاری‌گر بود که بی‌آن‌که دیده شود پشت صحنه کار می‌کرد. در لینوکس، daemon برنامه‌ای است که در پس‌زمینه همیشه روشن است، پنجره ندارد و منتظر کار می‌ماند: سرور وب، سرویس SSH، زمان‌بند cron. معمولا با روشن شدن کامپیوتر خودش راه می‌افتد. اسم خیلی از آن‌ها با d تمام می‌شود: sshd، dockerd، systemd.

The Docker daemon is not running, so the command cannot connect.

دیمن داکر روشن نیست، برای همین دستور نمی‌تواند وصل شود.

راهنمای وصل شدن به سرور آزمایشی

You can test the new feature on your local machine, but the real data is on the remote server.

1. SSH into the server: ssh sara@203.0.113.10
2. The app runs as a daemon, so it keeps running after you log out. Check it with: systemctl status shop
3. The admin panel only listens on port 9000 inside the server. Use port forwarding to open it from home.
4. The new search is behind a feature flag. Turn it on in the config file.

Users never see port 9000: Nginx is our reverse proxy.

ویژگی تازه را می‌توانی روی کامپیوتر خودت تست کنی، ولی داده‌ی واقعی روی سرور دوردست است.

۱. با SSH به سرور وصل شو: ssh sara@203.0.113.10
۲. برنامه به شکل یک daemon اجرا می‌شود، پس بعد از بیرون آمدن تو هم روشن می‌ماند. با این دستور بررسی‌اش کن: systemctl status shop
۳. پنل مدیریت فقط روی پورت ۹۰۰۰ درون سرور گوش می‌دهد. با port forwarding آن را از خانه باز کن.
۴. جست‌وجوی تازه پشت یک feature flag است. آن را در فایل تنظیمات روشن کن.

کاربرها هیچ‌وقت پورت ۹۰۰۰ را نمی‌بینند: Nginx پراکسی معکوس ماست.