GitHub 项目本地运行指南：Python/Node.js/Java 实战部署与容器化

二、Python 项目实战部署

2.1 安装依赖与运行基础项目

Python 项目的依赖管理通常通过 requirements.txt 文件完成，安装依赖的命令如下：

# 安装项目依赖
pip install -r requirements.txt

# 安装开发环境依赖（如果存在）
pip install -r dev-requirements.txt

如果项目包含 setup.py，还可以使用以下命令安装项目本身：

# 安装项目到 Python 环境
python setup.py install

# 或使用 pip 直接安装
pip install .

基础项目的运行方式多样，常见命令包括：

# 运行 Python 脚本
python main.py

# 启动 Web 服务器
python -m http.server 8000

# 使用 Flask 框架
flask run --host=0.0.0.0

# 使用 Django 框架
python manage.py runserver

2.2 使用 Docker 容器化部署

Docker 是 Python 项目部署的首选方案，能有效解决环境依赖问题。以下是完整的 Docker 部署流程：

1. 创建 Dockerfile

# 使用官方 Python 基础镜像
FROM python:3.9-slim

# 设置工作目录
WORKDIR /app

# 复制项目文件
COPY . .

# 安装依赖
RUN pip install --no-cache-dir -r requirements.txt

# 暴露端口
EXPOSE 5000

# 启动命令
CMD ["python", "main.py"]

2. 构建 Docker 镜像

# 构建镜像并指定名称和标签
docker build -t my-python-app:1.0 .

# 查看已构建的镜像
docker images

3. 运行 Docker 容器

# 运行容器并将宿主机端口映射到容器端口
docker run -d -p 8080:5000 --name myapp my-python-app:1.0

# 查看容器状态
docker ps -a

# 进入容器查看日志
docker logs -f myapp

2.3 GitHub Actions 实现 CI/CD

GitHub Actions 是自动化项目部署的强大工具。以下是 Python 项目的 CI/CD 工作流示例：

1. 创建 .github/workflows/ci-cd.yml 文件

name: Python CI/CD
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
        with:
          fetch-depth: 1
      - name: Set up Python
        uses: actions/setup-python@v2
        with:
          python-version: '3.9'
      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt
      - name: Run tests
        run: pytest

2. 部署到云服务器

deploy:
  runs-on: ubuntu-latest
  needs: build
  if: ${{ always() }}
  steps:
    - uses: actions/checkout@v2
    - name: Set up Python
      uses: actions/setup-python@v2
      with:
        python-version: '3.9'
    - name: Deploy to Azure
      uses: azure/login@v1
      with:
        credentials: ${{ secrets.AZURE_CREDENTIALS }}
      env:
        AZURE_RG: myresourcegroup
        AZURE_SUB: my subscription id

三、Node.js 项目实战部署

3.1 安装依赖与配置环境变量

Node.js 项目通常使用 package.json 管理依赖，安装依赖的命令如下：

# 安装项目依赖
npm install

# 安装开发环境依赖
npm install --dev

环境变量管理是 Node.js 项目的最佳实践：

1. 创建 .env 文件

NODE_ENV=development
PORT=3000
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=secretpass
API_KEY=your-api-key

2. 使用 dotenv 库加载环境变量

// 在应用入口文件中添加以下代码
require('dotenv').config();

// 然后即可在应用中使用环境变量
console.log(process.env.PORT);
console.log(process.env.DB_HOST);

3.2 使用 Docker 部署 Node.js 应用

1. 创建 Dockerfile

# 使用官方 Node.js 基础镜像
FROM node:16-alpine

# 设置工作目录
WORKDIR /app

# 复制 package.json 和 package-lock.json
COPY package*.json ./

# 安装依赖
RUN npm ci --only=production

# 复制项目文件
COPY . .

# 暴露端口
EXPOSE 3000

# 启动命令
CMD ["node", "app.js"]

2. 构建和运行 Docker 容器

# 构建 Docker 镜像
docker build -t my-node-app:1.0 .

# 运行容器
docker run -d -p 3000:3000 --name node-app my-node-app:1.0

# 查看运行状态
docker ps

3.3 GitHub Actions 实现 CI/CD

1. 创建 .github/workflows/ci.yml 文件

name: Node.js CI
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [14, 16]
    steps:
      - uses: actions/checkout@v2
      - name: Use Node.js ${{ matrix.node-version }}
        uses: actions/setup-node@v2
        with:
          node-version: ${{ matrix.node-version }}
      - name: Install dependencies
        run: npm install
      - name: Run tests
        run: npm test

2. 部署到云服务

deploy:
  needs: build
  runs-on: ubuntu-latest
  if: ${{ always() }}
  steps:
    - uses: actions/checkout@v2
    - name: Set up Node.js
      uses: actions/setup-node@v2
      with:
        node-version: '16'
    - name: Deploy to Heroku
      uses: akhileshns/heroku-deploy@master
      with:
        heroku-api-key: ${{ secrets.HEROKU_API_KEY }}
        heroku-app-name: "my-node-app"
      env:
        HEROKU_REGION: "us"

四、Java 项目实战部署

4.1 Maven 项目依赖管理

Java 项目通常使用 Maven 管理依赖，以下是基础配置：

1. 创建 pom.xml 文件

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>my-java-app</artifactId>
    <version>1.0-SNAPSHOT</version>
    <properties>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
    </properties>
    <dependencies>
        <!-- 添加项目依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>2.7.0</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <version>2.7.0</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <!-- 添加 Maven 插件 -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

2. 解决依赖冲突

# 分析依赖树
mvn dependency:tree

# 排除冲突依赖
mvn dependency:tree -Dincludes

以上涵盖了多语言项目在 GitHub 上的基本运行与部署流程。