# 001 git如何上传


# 002 git如何上传到子目录



git config --global user.name "fei"
git config --global user.email "fei@fei.fei"


在 Linux 中使用 `git` 命令连接自建的 Gitea 仓库并完成初始化提交，主要分为**配置环境**、**在 Gitea 网页端创建仓库**（Git 本身不提供远程创建仓库的命令，除非使用 API）以及**本地操作**三个步骤。

以下是具体的操作流程：

### 1. 配置本地 Git 环境

如果是第一次使用 Git，需要先配置身份标识，否则提交会报错。

```bash
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

```

---

### 2. 在 Gitea 网页端手动创建仓库

Git 协议本身不支持通过命令行直接在远程服务器上“新建”一个项目。你需要：

1. 登录你的 Gitea 页面。
2. 点击右上角的 **+** 号 -> **新建仓库**。
3. 输入 **仓库名称**（例如：`my-project`），不要勾选“初始化仓库”（保持仓库为空）。
4. 点击 **创建仓库**，获取仓库地址（推荐使用 SSH 或 HTTPS）。

---

### 3. 初始化并提交当前文件夹

进入你想要上传的文件夹，执行以下操作：

```bash
# 进入目标文件夹
cd /path/to/your/folder

# 1. 初始化本地仓库
git init

# 2. 将文件夹下的所有文件添加到暂存区
git add .

# 3. 提交到本地仓库
git commit -m "首次提交：初始化项目"

# 4. 关联 Gitea 远程仓库
# 请将下方链接替换为你刚才在 Gitea 创建仓库后获取的地址
git remote add origin http://your-gitea-ip:3000/username/my-project.git

# 5. 推送到远程仓库（通常主分支名为 master 或 main）
git push -u origin master

```

---

### 常见问题排查

#### 方式选择：HTTPS vs SSH

* **HTTPS**: 每次推送可能需要输入 Gitea 的用户名和密码。如果你想免密，可以使用：
`git config --global credential.helper store`
* **SSH (推荐)**: 需要将你 Linux 机器的公钥（`~/.ssh/id_rsa.pub`）添加到 Gitea 的“个人设置 -> SSH / GPG 密钥”中。这样后续推送无需密码。

#### 关于 /home/fei/k3s/ 目录的特别提醒

考虑到你习惯将配置文件放在 `/home/fei/k3s/`，如果该目录下包含敏感信息（如 `kubeconfig` 或 S3 的 Secret 密钥），建议在 `git init` 后立即创建一个 `.gitignore` 文件：

```bash
echo "credentials.yaml" >> .gitignore
echo "*.log" >> .gitignore

```

#### 修改分支名

现在的 Gitea 默认分支可能叫 `main`。如果你推送时报错，可以尝试先重命名本地分支再推送：

```bash
git branch -M main
git push -u origin main

```

你想了解如何通过 Gitea API 使用命令行自动创建远程仓库，从而跳过网页操作吗？


是的，你需要**先在 Gitea 网页端手动创建一个仓库**，然后才能在命令行关联它。

即使你本地已经有文件夹和代码了，Git 也无法直接通过 `remote add` 命令在服务器上“生”出一个仓库。

### 第一步：在 Gitea 网页端创建仓库

1. 打开浏览器，访问 `https://git.jpd.net3w.com`（推荐使用 HTTPS）。
2. 使用账号 `gitea_admin` 登录。
3. 点击页面右上角的 **+** 号 -> **创建仓库**。
4. **仓库名称**：填 `k3s_auto_deploy`（或者任何你喜欢的名字）。
5. **注意**：**不要**勾选“初始化仓库”、“设置 .gitignore”或“选择授权许可”。我们要的是一个**完全空白**的仓库。
6. 点击底部的 **创建仓库**。

---

### 第二步：在本地 Linux 终端执行命令

创建好后，Gitea 会显示该仓库的地址。根据你的信息，命令应该这样写：

```bash
# 1. 关联远程仓库 (推荐使用域名 HTTPS 方式)
git remote add origin https://git.jpd.net3w.com/gitea_admin/k3s_auto_deploy.git

# 2. 如果你想使用 NodePort 方式（备选）：
# git remote add origin http://149.13.91.216:30080/gitea_admin/k3s_auto_deploy.git

# 3. 推送代码
# 第一次推送时，Git 会弹窗或提示你输入用户名和密码
# 用户名: gitea_admin
# 密码: 12341234
git push -u origin master

```

---

### 进阶：如何实现“免密”推送？

由于你使用的是 HTTPS 链接，每次 `push` 可能都要输密码，这在自动化部署中很不方便。你有两个选择：

1. **让 Git 记住密码（简单）：**
执行 `git config --global credential.helper store`。下次输入正确后，密码会加密存在你的 `/home/fei/` 目录下。
2. **使用 SSH 密钥（专业）：**
将你的 `~/.ssh/id_rsa.pub` 内容复制到 Gitea 的“个人设置 -> SSH / GPG 密钥”中。然后将远程地址改为 SSH 格式：
`git remote set-url origin git@git.jpd.net3w.com:gitea_admin/k3s_auto_deploy.git`

---

**小贴士：**
在执行 `git push` 之前，别忘了处理上一步提到的 `k3s-ansible` 文件夹。如果你决定把它当作普通文件夹处理，记得先运行：
`rm -rf k3s-ansible/.git && git add . && git commit -m "准备好推送了"`

关联仓库后，推送成功了吗？如果不成功，请把报错信息发给我。







建议操作：建立一个专门的“知识库”仓库
除了项目相关的文档，你还可以单独建一个名为 Wiki 或 Knowledge 的仓库：

分门别类：创建 /K3s/、/Networking/、/Linux-Commands/ 等文件夹。

随时提交：在本地用你习惯的编辑器（比如 Cursor 或 VS Code）写完，一个 git push 就同步到了你的私有云端。

多端同步：你可以在家里电脑、公司电脑甚至手机上（通过支持 Git 的编辑器）随时查看这些文档。

一个小技巧： 如果你在本地 k3s自动化部署 文件夹里写了多份 .md 文件，你可以给它们起个好名字，比如 01-环境准备.md、02-安装脚本说明.md。

你现在关联并推送成功了吗？如果成功了，你打开 http://git.jpd.net3w.com 就能看到你的文档已经整整齐齐地躺在私有仓库里了。




# 002 git到子目录


当然可以。在 Git 中，将一个现有的本地文件夹“推”送到远程仓库的某个子目录下，通常有几种不同的实现方式，取决于你的具体需求（是想彻底合并，还是作为独立模块管理）。

以下是几种最常用的方案：

---

### 方案一：最简单直接的“搬运”法

如果你只是想把当前文件夹里的内容塞进远程仓库的一个文件夹里，这是最稳妥的办法：

1. **克隆远程仓库**到另一个临时目录：
`git clone <远程仓库地址> temp-repo`
2. **创建目标子目录**：
`mkdir -p temp-repo/子目录名`
3. **拷贝文件**：
将你当前文件夹（`/home/fei/k3s/` 等）下的内容手动或使用 `cp` 命令拷贝到 `temp-repo/子目录名` 下。
4. **提交并推送**：
```bash
cd temp-repo
git add .
git commit -m "Add k3s configs to subfolder"
git push

```



---

### 方案二：使用 `git subtree` (保留提交历史)

如果你希望保留当前本地文件夹之前的 **Git 提交记录**，并将其并入另一个大仓库的子目录，可以使用 `subtree`。

假设你已经在当前文件夹初始化了 Git 并有提交记录：

1. 在本地关联远程大仓库：
`git remote add big-repo <大仓库地址>`
2. 使用 `subtree` 推送到指定分支和目录：
```bash
git push big-repo <当前分支名>:refs/heads/<目标分支名>

```


*注意：这种方式比较底层。更标准的做法是在大仓库里执行 `pull`：*
```bash
# 在大仓库目录下执行
git subtree add --prefix=k3s-configs <你的配置文件库地址> master --squash

```



---

### 方案三：使用 Git Submodule (模块化管理)

如果你希望这个子目录**保持独立性**（即它依然是一个独立的仓库，只是被大仓库“引用”），Submodule 是最佳选择。

1. 先将当前文件夹推送到它自己的远程仓库（比如 `k3s-backup`）。
2. 进入你的大仓库目录，运行：
```bash
git submodule add <配置文件仓库地址> 子目录名
git commit -m "Add k3s configs as submodule"
git push

```



---

### 总结建议

| 需求场景 | 推荐方案 |
| --- | --- |
| **纯备份，不需要复杂的关联** | **方案一** (手动拷贝) |
| **想在大仓库里看到所有历史记录** | **方案二** (Subtree) |
| **配置目录经常独立更新，多处复用** | **方案三** (Submodule) |

由于你提到你的配置文件通常在 `/home/fei/k3s/`，建议先检查该目录下是否有 `.git` 隐藏文件夹。如果有，采用方案二或三可以保留你的修改痕迹。

**需要我帮你写一个具体的脚本来自动化这个推送过程吗？**