在GitLab创建静态网站遇问题：未生成Pages URL求助

Hey there, let's troubleshoot why your GitLab Pages URL isn't showing up after forking the plain-html repo and modifying the README. Here are the most common checks you should run through:

1. First, confirm your pipeline actually succeeded #

After pushing your README change, head over to CI/CD > Pipelines in your project. If the pipeline has a red failed status, that’s the root cause—GitLab Pages won’t generate a URL if the deployment pipeline fails.

Even though the plain-html repo has a default working .gitlab-ci.yml, double-check the file in your forked project to make sure you didn’t accidentally modify its syntax or delete critical steps (like the pages job that deploys static files).

2. Verify the pages job ran successfully #

Dig into the details of your pipeline and look for the job named pages. This is the specific job responsible for deploying your static site to GitLab Pages. If it didn’t run at all, or shows a failure:

• Go to Settings > CI/CD > General pipelines and confirm "CI/CD pipelines are enabled" is checked.
• Check the job logs for error messages—they’ll tell you exactly what went wrong (e.g., missing files in the public folder, permission issues).

3. Check Pages visibility and settings #

Even if the pipeline succeeded, your Pages might be hidden due to visibility settings:

• Navigate to Settings > General > Visibility, project features, permissions
• Find the "Pages" section and ensure it’s set to "Everyone" (for public access) or at least "Project members" (if your project is private). If it’s disabled, enable it and wait a few minutes for changes to take effect.

4. Give it a few minutes (seriously!) #

GitLab sometimes takes 5-10 minutes to sync and display the Pages URL after a successful deployment, especially for the first time. If your pipeline shows success but the URL is missing, refresh the Settings > Pages page a few times after waiting a bit.

5. Confirm your static files are intact #

The plain-html repo deploys content from the public folder. Make sure you didn’t delete this folder or remove the index.html file inside it—without these, there’s nothing for GitLab to host.

If none of these steps fix the issue, grab the error logs from the failed pages job (if any) and share them, and we can dive deeper!

内容的提问来源于stack exchange，提问作者Victor Gau