修改镜像地址
Browse files- Dockerfile +6 -2
- TROUBLESHOOTING.md +92 -0
Dockerfile
CHANGED
|
@@ -1,6 +1,10 @@
|
|
| 1 |
# 使用预构建镜像的 Hugging Face Spaces 部署
|
| 2 |
-
#
|
| 3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 4 |
|
| 5 |
# 暴露HF Spaces标准端口
|
| 6 |
EXPOSE 7860
|
|
|
|
| 1 |
# 使用预构建镜像的 Hugging Face Spaces 部署
|
| 2 |
+
# ⚠️ 请将下面的镜像名称替换为你的实际镜像名称
|
| 3 |
+
#
|
| 4 |
+
# 如果是Docker Hub镜像: FROM your-username/your-image:tag
|
| 5 |
+
# 如果是私有仓库镜像: FROM your-registry.com/your-image:tag
|
| 6 |
+
#
|
| 7 |
+
FROM ghcr.io/gdtiti/aistudiobuildws:main
|
| 8 |
|
| 9 |
# 暴露HF Spaces标准端口
|
| 10 |
EXPOSE 7860
|
TROUBLESHOOTING.md
ADDED
|
@@ -0,0 +1,92 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# 🔧 Docker 镜像部署问题解决
|
| 2 |
+
|
| 3 |
+
## ❌ 错误信息
|
| 4 |
+
```
|
| 5 |
+
ERROR: pull access denied, repository does not exist or may require authorization:
|
| 6 |
+
server message: insufficient_scope: authorization failed
|
| 7 |
+
```
|
| 8 |
+
|
| 9 |
+
## 🔍 问题原因
|
| 10 |
+
|
| 11 |
+
1. **镜像名称不正确** - `docker.io/library/my-image-name:1763908533` 是示例名称
|
| 12 |
+
2. **私有仓库需要认证** - HF Spaces无法直接访问私有镜像
|
| 13 |
+
3. **镜像不存在或标签错误**
|
| 14 |
+
|
| 15 |
+
## ✅ 解决方案
|
| 16 |
+
|
| 17 |
+
### 方案1: 使用正确的镜像名称
|
| 18 |
+
|
| 19 |
+
将 `J:\_Workings\_Cli\yyyy\Dockerfile` 第7行中的镜像名称替换为你的实际镜像:
|
| 20 |
+
|
| 21 |
+
```dockerfile
|
| 22 |
+
# 示例格式 - 选择适合你的情况:
|
| 23 |
+
|
| 24 |
+
# Docker Hub 公共镜像
|
| 25 |
+
FROM your-dockerhub-username/your-image-name:1763908533
|
| 26 |
+
|
| 27 |
+
# Docker Hub 私有镜像(需要认证)
|
| 28 |
+
FROM your-dockerhub-username/your-image-name:1763908533
|
| 29 |
+
|
| 30 |
+
# 私有仓库镜像
|
| 31 |
+
FROM your-registry.com/your-namespace/your-image-name:1763908533
|
| 32 |
+
|
| 33 |
+
# 如果是本地构建的镜像,建议推送到Docker Hub
|
| 34 |
+
```
|
| 35 |
+
|
| 36 |
+
### 方案2: 推送镜像到Docker Hub(推荐)
|
| 37 |
+
|
| 38 |
+
如果你有本地的镜像,按以下步骤操作:
|
| 39 |
+
|
| 40 |
+
```bash
|
| 41 |
+
# 1. 为镜像打标签
|
| 42 |
+
docker tag my-image-name:1763908533 your-dockerhub-username/ai-studio-build:latest
|
| 43 |
+
|
| 44 |
+
# 2. 推送到Docker Hub
|
| 45 |
+
docker push your-dockerhub-username/ai-studio-build:latest
|
| 46 |
+
|
| 47 |
+
# 3. 更新Dockerfile中的镜像名称为:
|
| 48 |
+
# FROM your-dockerhub-username/ai-studio-build:latest
|
| 49 |
+
```
|
| 50 |
+
|
| 51 |
+
### 方案3: 使用源代码部署(备选)
|
| 52 |
+
|
| 53 |
+
如果无法使用预构建镜像,可以改为直接使用源代码:
|
| 54 |
+
|
| 55 |
+
1. 将 `AIStudioBuildWS` 中的所有文件复制到Space
|
| 56 |
+
2. 修改 README.md 中的 `sdk: docker` 为 `sdk: python`
|
| 57 |
+
3. 保留 `requirements.txt` 和源代码
|
| 58 |
+
|
| 59 |
+
### 方案4: 私有仓库认证(高级)
|
| 60 |
+
|
| 61 |
+
如果必须使用私有镜像,在HF Spaces设置中添加环境变量:
|
| 62 |
+
- `DOCKER_USERNAME` - 你的用户名
|
| 63 |
+
- `DOCKER_PASSWORD` - 你的密码或访问令牌
|
| 64 |
+
- `DOCKER_REGISTRY` - 私有仓库地址(如果不是Docker Hub)
|
| 65 |
+
|
| 66 |
+
## 🚀 快速检查清单
|
| 67 |
+
|
| 68 |
+
- [ ] 确认镜像名称:`docker images` 查看本地镜像
|
| 69 |
+
- [ ] 确认镜像已推送:`docker push` 到公共仓库
|
| 70 |
+
- [ ] 更新 Dockerfile 中的 FROM 行
|
| 71 |
+
- [ ] 重新提交到HF Spaces
|
| 72 |
+
|
| 73 |
+
## 📞 获取帮助
|
| 74 |
+
|
| 75 |
+
1. **查看本地镜像**:
|
| 76 |
+
```bash
|
| 77 |
+
docker images | grep 1763908533
|
| 78 |
+
```
|
| 79 |
+
|
| 80 |
+
2. **检查镜像是否存在**:
|
| 81 |
+
```bash
|
| 82 |
+
docker pull your-username/your-image:tag
|
| 83 |
+
```
|
| 84 |
+
|
| 85 |
+
3. **推送镜像到Docker Hub**:
|
| 86 |
+
```bash
|
| 87 |
+
docker login
|
| 88 |
+
docker tag local-image:tag username/remote-image:tag
|
| 89 |
+
docker push username/remote-image:tag
|
| 90 |
+
```
|
| 91 |
+
|
| 92 |
+
请告诉我你的实际镜像名称,我可以帮你更新配置!
|