Skip to content

Commit

Permalink
Docs: modify QuickStart.md
Browse files Browse the repository at this point in the history
modify QuickStart.md
  • Loading branch information
Zherphy committed Oct 11, 2024
1 parent d45343d commit 5fd628e
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 37 deletions.
4 changes: 2 additions & 2 deletions docs/BasicGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Git LFS initialized.
  url = https://lfs.test.osinfra.cn/{owner}/{repo}
```

或者通过命令行设置仓库中LFS远程地址:
- 或者通过命令行设置仓库中LFS远程地址:

```
git config --local lfs.url https://lfs.test.osinfra.cn/{owner}/{repo}
Expand Down Expand Up @@ -341,4 +341,4 @@ git config --global filter.lfs.process "git-lfs filter-process --skip"
```
git config --global filter.lfs.smudge "git-lfs smudge -- %f"
git config --global filter.lfs.process "git-lfs filter-process"
```
```
64 changes: 29 additions & 35 deletions docs/QuickStart.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,22 +2,20 @@

## 准备工作

[下载](BasicGuide.md#下载)
[安装](BasicGuide.md#安装)
请确保您在本地环境中已安装GIT LFS。详阅[安装指导](BasicGuide.md#安装)

## 第三方LFS服务使用配置

- 创建.lfsconfig文件
通过.lfsconfig文件来配置lfs服务大文件的远程地址,使得将仓库中的大文件上传至BigFiles中。

在仓库根目录下创建.lfsconfig文件以指定第三方LFS服务,文件内容如下:

```
# .lfsconfig文件的格式为
[lfs]
  url = https://lfs.test.osinfra.cn/{owner}/{repo}
```

或者通过命令行设置仓库中LFS远程地址:
- 或者通过命令行设置仓库中LFS远程地址:

```
$ git config --local lfs.url https://lfs.test.osinfra.cn/{owner}/{repo}
Expand All @@ -27,41 +25,42 @@ $ git config --local lfs.url https://lfs.test.osinfra.cn/{owner}/{repo}

## 第三方LFS服务与Gitee的使用差异

- 在fork一个已经使用第三方LFS服务作为LFS远程服务的仓库后,需要手动修改新仓库中LFS远程地址中的{owner}以及{repo},否则会出现权限校验问题,**错误代码401**
- 在使用SSH对Gitee仓库进行克隆后,在使用第三方LFS服务作为LFS远程服务时,仍然需要输入账户和密码。
- 当您fork一个仓库:
- 在fork一个已经使用第三方LFS服务作为LFS远程服务的仓库后,需要手动修改新仓库中LFS远程地址中的{owner}以及{repo},否则会出现权限校验问题,**错误代码401**
- 当您使用ssh协议进行克隆或推送:
- 在使用SSH对Gitee仓库进行克隆后,在使用第三方LFS服务作为LFS远程服务时,仍然需要输入账户和密码。

## 迁移Gitee中使用LFS服务的仓库中的大文件

- 克隆仓库

```
$ git clone <url>
```
1. 克隆仓库

- 在克隆仓库之后,想要获取远端仓库的最新LFS对象
```
$ git clone <url>
```
```
$ git lfs fetch --all origin
```
2. 在克隆仓库之后,想要获取远端仓库的最新LFS对象
git lfs fetch命令会从远程仓库中获取所有缺失的Git LFS对象,但不会将这些对象应用到你的工作目录中。如果想将这些对象应用到工作目录中,需要使用git lfs checkout命令。
```
$ git lfs fetch --all origin
```
git lfs fetch命令会从远程仓库中获取所有缺失的Git LFS对象,但不会将这些对象应用到你的工作目录中。如果想将这些对象应用到工作目录中,需要使用git lfs checkout命令。
- 通过.lfsconfig文件来[配置lfs服务](QuickStart.md#第三方lfs服务使用配置)大文件的远程地址
3. 通过.lfsconfig文件来[配置lfs服务](QuickStart.md#第三方lfs服务使用配置)大文件的远程地址
```
$ git add .
$ git commit -m "modify .lfsconfig"
```
```
$ git add .
$ git commit -m "modify .lfsconfig"
```
- 执行:
4. 执行:
```
$ git lfs push --all origin
$ git push --all --force origin
$ git push --tags --force origin
```
```
$ git lfs push --all origin
$ git push
```
- 原仓库中的lfs文件成功存储于第三方lfs服务中
5. 原仓库中的lfs文件成功存储于第三方lfs服务中
## 关闭第三方LFS功能
Expand All @@ -79,8 +78,3 @@ $ git push
```
$ git config lfs.url ""
```





0 comments on commit 5fd628e

Please sign in to comment.