Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

GITEA_WORK_DIR not being used for GITEA_CUSTOM when looking up locales #21498

Closed
plsnp opened this issue Oct 18, 2022 · 0 comments · Fixed by #25330
Closed

GITEA_WORK_DIR not being used for GITEA_CUSTOM when looking up locales #21498

plsnp opened this issue Oct 18, 2022 · 0 comments · Fixed by #25330
Labels

Comments

@plsnp
Copy link
Contributor

plsnp commented Oct 18, 2022

Description

https://docs.gitea.io/en-us/environment-variables/

The documentation says:

GITEA_CUSTOM: Gitea uses GITEA_WORK_DIR/custom folder by default. Use this variable to change custom directory.

However setting GITEA_WORK_DIR is not sufficient for looking up locales and GITEA_CUSTOM must be set explicitly.

gitea2@myserver~/gitea
» HOME=/home/gitea2 GITEA_WORK_DIR=/home/gitea2/gitea /usr/local/bin/gitea2 -c /home/gitea2/gitea/conf/app.ini web
.. some log messages before
2022/10/18 15:16:59 ...ation/translation.go:60:InitLocales() [F] Failed to list locale files: Failed to check if custom directory stat /etc/gitea/options/locale: permission denied is a directory. %!v(MISSING)
gitea2@myserver~/gitea
» HOME=/home/gitea2 GITEA_CUSTOM=/home/gitea2/gitea/custom GITEA_WORK_DIR=/home/gitea2/gitea /usr/local/bin/gitea2 -c /home/gitea2/gitea/conf/app.ini web
2022/10/18 15:17:25 cmd/web.go:106:runWeb() [I] Starting Gitea on PID: 23564
.. after this failure doesn't show up and booting of gitea continues ..

I looked in app.ini for keywords etc and locale but i didn't see any reason why it might be reading from the path /etc/gitea/options/locale

Gitea Version

1.17.3

Can you reproduce the bug on the Gitea demo site?

No

Log Gist

No response

Screenshots

No response

Git Version

No response

Operating System

No response

How are you running Gitea?

downloaded binary from official website

Database

PostgreSQL

@plsnp plsnp added the type/bug label Oct 18, 2022
@lunny lunny closed this as completed in 2cdf260 Jun 21, 2023
wxiaoguang added a commit to wxiaoguang/gitea that referenced this issue Jun 21, 2023
# The problem

There were many "path tricks":

* By default, Gitea uses its program directory as its work path
* Gitea tries to use the "work path" to guess its "custom path" and
"custom conf (app.ini)"
* Users might want to use other directories as work path
* The non-default work path should be passed to Gitea by GITEA_WORK_DIR
or "--work-path"
* But some Gitea processes are started without these values
    * The "serv" process started by OpenSSH server
    * The CLI sub-commands started by site admin
* The paths are guessed by SetCustomPathAndConf again and again
* The default values of "work path / custom path / custom conf" can be
changed when compiling

# The solution

* Use `InitWorkPathAndCommonConfig` to handle these path tricks, and use
test code to cover its behaviors.
* When Gitea's web server runs, write the WORK_PATH to "app.ini", this
value must be the most correct one, because if this value is not right,
users would find that the web UI doesn't work and then they should be
able to fix it.
* Then all other sub-commands can use the WORK_PATH in app.ini to
initialize their paths.
* By the way, when Gitea starts for git protocol, it shouldn't output
any log, otherwise the git protocol gets broken and client blocks
forever.

The "work path" priority is: WORK_PATH in app.ini > cmd arg --work-path
> env var GITEA_WORK_DIR > builtin default

The "app.ini" searching order is: cmd arg --config > cmd arg "work path
/ custom path" > env var "work path / custom path" > builtin default

## ⚠️ BREAKING

If your instance's "work path / custom path / custom conf" doesn't meet
the requirements (eg: work path must be absolute), Gitea will report a
fatal error and exit. You need to set these values according to the
error log.

----

Close go-gitea#24818
Close go-gitea#24222
Close go-gitea#21606
Close go-gitea#21498
Close go-gitea#25107
Close go-gitea#24981
Maybe close go-gitea#24503

Replace go-gitea#23301
Replace go-gitea#22754

And maybe more
# Conflicts:
#	cmd/web.go
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Aug 6, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant