series Railway Bài 2: Triển Khai (Deploy) Dự Án Đầu Tiên Từ GitHub

Bây giờ, chúng ta sẽ bắt tay vào phần thú vị nhất: đưa những dòng code đầu tiên của bạn lên internet.

Hôm nay, chúng ta sẽ sử dụng một ứng dụng Backend rất đơn giản (bằng Node.js) làm ví dụ. Railway cực kỳ thông minh, nó có thể tự động nhận diện ngôn ngữ bạn viết và biết cách chạy nó.

1. Chuẩn bị "nguyên liệu" (Tạo kho chứa trên GitHub)

Để Railway có thứ để deploy, bạn cần có code trên GitHub. Hãy làm theo các bước sau:

1. Đăng nhập vào GitHub và tạo một Repository (kho chứa) mới, đặt tên là my-first-railway-app.
2. Trong kho chứa này, bạn tạo 2 file cơ bản để chạy một máy chủ Node.js nhỏ:

File 1: package.json (Để Railway biết đây là dự án Node.js và cách khởi động nó)

{
  "name": "my-first-railway-app",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  }
}

File 2: index.js (Mã nguồn chính của ứng dụng)

const express = require('express');
const app = express();
const port = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.send('Xin chào! Đây là dự án đầu tiên của tôi trên Railway!');
});

app.listen(port, () => {
  console.log(`Ứng dụng đang chạy trên port ${port}`);
});

Lưu ý quan trọng: Trong đoạn code trên, process.env.PORT là cách ứng dụng lắng nghe cổng mạng mà Railway cấp phát tự động. Đây là quy tắc bắt buộc khi deploy lên môi trường đám mây.

2. Kết nối Railway với GitHub

Bây giờ, hãy quay lại bảng điều khiển (Dashboard) của Railway:

1. Nhấn vào nút New Project (Tạo dự án mới).
2. Chọn Deploy from GitHub repo.
3. Bạn có thể sẽ được yêu cầu cấp quyền cho Railway truy cập vào GitHub của bạn. Hãy nhấn đồng ý (Authorize).
4. Tìm và chọn repository my-first-railway-app mà bạn vừa tạo ở bước 1.
5. Nhấn Deploy Now.

3. Quan sát quá trình "Phép thuật" xảy ra

Ngay khi bạn nhấn Deploy, Railway sẽ tự động làm những việc sau (bạn có thể xem quá trình này trong tab Deployments):

• Nhận diện (Detect): Nó đọc file package.json và hiểu "À, đây là một dự án Node.js".
• Xây dựng (Build): Nó tải về các thư viện cần thiết (ở đây là express).
• Chạy (Run): Nó kích hoạt lệnh npm start để khởi động máy chủ.

Khi bạn thấy một dòng chữ màu xanh lá cây hiện lên chữ Success (Thành công), nghĩa là ứng dụng của bạn đã chạy trên máy chủ của Railway!

4. Tạo đường dẫn (URL) để mọi người truy cập

Dù ứng dụng đã chạy, nhưng nó đang ở "trong nhà đóng cửa". Bạn cần tạo một địa chỉ web để mọi người có thể truy cập:

1. Trong giao diện Project của Railway, click vào Service (khối vuông chứa tên ứng dụng của bạn).
2. Chuyển sang tab Settings (Cài đặt).
3. Kéo xuống phần Networking, tìm mục Public Networking.
4. Nhấn vào nút Generate Domain.

Railway sẽ ngay lập tức cấp cho bạn một đường dẫn (ví dụ: my-first-app-production.up.railway.app). Hãy click vào đường link đó, bạn sẽ thấy dòng chữ "Xin chào! Đây là dự án đầu tiên của tôi trên Railway!" hiện lên trên trình duyệt.