8.5 KiB
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，需要先配置身份标识，否则提交会报错。
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
2. 在 Gitea 网页端手动创建仓库
Git 协议本身不支持通过命令行直接在远程服务器上“新建”一个项目。你需要：
- 登录你的 Gitea 页面。
- 点击右上角的 + 号 -> 新建仓库。
- 输入 仓库名称（例如：
my-project），不要勾选“初始化仓库”（保持仓库为空）。 - 点击 创建仓库，获取仓库地址（推荐使用 SSH 或 HTTPS）。
3. 初始化并提交当前文件夹
进入你想要上传的文件夹，执行以下操作：
# 进入目标文件夹
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 文件：
echo "credentials.yaml" >> .gitignore
echo "*.log" >> .gitignore
修改分支名
现在的 Gitea 默认分支可能叫 main。如果你推送时报错，可以尝试先重命名本地分支再推送：
git branch -M main
git push -u origin main
你想了解如何通过 Gitea API 使用命令行自动创建远程仓库，从而跳过网页操作吗？
是的，你需要先在 Gitea 网页端手动创建一个仓库，然后才能在命令行关联它。
即使你本地已经有文件夹和代码了，Git 也无法直接通过 remote add 命令在服务器上“生”出一个仓库。
第一步：在 Gitea 网页端创建仓库
- 打开浏览器，访问
https://git.jpd.net3w.com（推荐使用 HTTPS）。 - 使用账号
gitea_admin登录。 - 点击页面右上角的 + 号 -> 创建仓库。
- 仓库名称：填
k3s_auto_deploy（或者任何你喜欢的名字）。 - 注意：不要勾选“初始化仓库”、“设置 .gitignore”或“选择授权许可”。我们要的是一个完全空白的仓库。
- 点击底部的 创建仓库。
第二步：在本地 Linux 终端执行命令
创建好后，Gitea 会显示该仓库的地址。根据你的信息，命令应该这样写：
# 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 可能都要输密码，这在自动化部署中很不方便。你有两个选择：
- 让 Git 记住密码（简单）：
执行
git config --global credential.helper store。下次输入正确后，密码会加密存在你的/home/fei/目录下。 - 使用 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 中，将一个现有的本地文件夹“推”送到远程仓库的某个子目录下，通常有几种不同的实现方式，取决于你的具体需求（是想彻底合并，还是作为独立模块管理）。
以下是几种最常用的方案：
方案一：最简单直接的“搬运”法
如果你只是想把当前文件夹里的内容塞进远程仓库的一个文件夹里，这是最稳妥的办法：
- 克隆远程仓库到另一个临时目录：
git clone <远程仓库地址> temp-repo - 创建目标子目录：
mkdir -p temp-repo/子目录名 - 拷贝文件：
将你当前文件夹（
/home/fei/k3s/等）下的内容手动或使用cp命令拷贝到temp-repo/子目录名下。 - 提交并推送：
cd temp-repo
git add .
git commit -m "Add k3s configs to subfolder"
git push
方案二：使用 git subtree (保留提交历史)
如果你希望保留当前本地文件夹之前的 Git 提交记录，并将其并入另一个大仓库的子目录，可以使用 subtree。
假设你已经在当前文件夹初始化了 Git 并有提交记录：
- 在本地关联远程大仓库：
git remote add big-repo <大仓库地址> - 使用
subtree推送到指定分支和目录：
git push big-repo <当前分支名>:refs/heads/<目标分支名>
注意：这种方式比较底层。更标准的做法是在大仓库里执行 pull：
# 在大仓库目录下执行
git subtree add --prefix=k3s-configs <你的配置文件库地址> master --squash
方案三：使用 Git Submodule (模块化管理)
如果你希望这个子目录保持独立性（即它依然是一个独立的仓库，只是被大仓库“引用”），Submodule 是最佳选择。
- 先将当前文件夹推送到它自己的远程仓库（比如
k3s-backup）。 - 进入你的大仓库目录，运行：
git submodule add <配置文件仓库地址> 子目录名
git commit -m "Add k3s configs as submodule"
git push
总结建议
| 需求场景 | 推荐方案 |
|---|---|
| 纯备份，不需要复杂的关联 | 方案一 (手动拷贝) |
| 想在大仓库里看到所有历史记录 | 方案二 (Subtree) |
| 配置目录经常独立更新，多处复用 | 方案三 (Submodule) |
由于你提到你的配置文件通常在 /home/fei/k3s/，建议先检查该目录下是否有 .git 隐藏文件夹。如果有，采用方案二或三可以保留你的修改痕迹。
需要我帮你写一个具体的脚本来自动化这个推送过程吗？