From 29972e2c93fec78085901c1200fda70c24ed4544 Mon Sep 17 00:00:00 2001 From: tobi <31960611+tsmethurst@users.noreply.github.com> Date: Tue, 2 Apr 2024 11:29:46 +0200 Subject: [PATCH] [feature] Add `enable` command to mirror existing `disable` command; update docs (#2792) * [feature] add `enable` CLI command to mirror existing `disable` command * update docs --- .../action/admin/account/account.go | 39 +++++++- cmd/gotosocial/admin.go | 15 +++- docs/admin/cli.md | 89 +++++++++++++++++-- docs/getting_started/user_creation.md | 27 +++--- 4 files changed, 145 insertions(+), 25 deletions(-) diff --git a/cmd/gotosocial/action/admin/account/account.go b/cmd/gotosocial/action/admin/account/account.go index 612f10cc8..e2fd82642 100644 --- a/cmd/gotosocial/action/admin/account/account.go +++ b/cmd/gotosocial/action/admin/account/account.go @@ -30,6 +30,7 @@ "github.com/superseriousbusiness/gotosocial/internal/gtsmodel" "github.com/superseriousbusiness/gotosocial/internal/log" "github.com/superseriousbusiness/gotosocial/internal/state" + "github.com/superseriousbusiness/gotosocial/internal/util" "github.com/superseriousbusiness/gotosocial/internal/validate" "golang.org/x/crypto/bcrypt" ) @@ -294,7 +295,43 @@ func stopState(state *state.State) error { return err } - user.Disabled = func() *bool { d := true; return &d }() + user.Disabled = util.Ptr(true) + return state.DB.UpdateUser( + ctx, user, + "disabled", + ) +} + +// Enable sets Disabled to false on a user. +var Enable action.GTSAction = func(ctx context.Context) error { + state, err := initState(ctx) + if err != nil { + return err + } + + defer func() { + // Ensure state gets stopped on return. + if err := stopState(state); err != nil { + log.Error(ctx, err) + } + }() + + username := config.GetAdminAccountUsername() + if err := validate.Username(username); err != nil { + return err + } + + account, err := state.DB.GetAccountByUsernameDomain(ctx, username, "") + if err != nil { + return err + } + + user, err := state.DB.GetUserByAccountID(ctx, account.ID) + if err != nil { + return err + } + + user.Disabled = util.Ptr(false) return state.DB.UpdateUser( ctx, user, "disabled", diff --git a/cmd/gotosocial/admin.go b/cmd/gotosocial/admin.go index 3b2ea69e3..41eb40633 100644 --- a/cmd/gotosocial/admin.go +++ b/cmd/gotosocial/admin.go @@ -108,7 +108,7 @@ func adminCommands() *cobra.Command { adminAccountDisableCmd := &cobra.Command{ Use: "disable", - Short: "prevent a local account from signing in or posting etc, but don't delete anything", + Short: "set 'disabled' to true on a local account to prevent it from signing in or posting etc, but don't delete anything", PreRunE: func(cmd *cobra.Command, args []string) error { return preRun(preRunArgs{cmd: cmd}) }, @@ -119,6 +119,19 @@ func adminCommands() *cobra.Command { config.AddAdminAccount(adminAccountDisableCmd) adminAccountCmd.AddCommand(adminAccountDisableCmd) + adminAccountEnableCmd := &cobra.Command{ + Use: "enable", + Short: "undo a previous disable command by setting 'disabled' to false on a local account", + PreRunE: func(cmd *cobra.Command, args []string) error { + return preRun(preRunArgs{cmd: cmd}) + }, + RunE: func(cmd *cobra.Command, args []string) error { + return run(cmd.Context(), account.Enable) + }, + } + config.AddAdminAccount(adminAccountEnableCmd) + adminAccountCmd.AddCommand(adminAccountEnableCmd) + adminAccountPasswordCmd := &cobra.Command{ Use: "password", Short: "set a new password for the given local account", diff --git a/docs/admin/cli.md b/docs/admin/cli.md index 405093531..e4fc461c9 100644 --- a/docs/admin/cli.md +++ b/docs/admin/cli.md @@ -20,18 +20,34 @@ Usage: Available Commands: admin gotosocial admin-related tasks - completion generate the autocompletion script for the specified shell debug gotosocial debug-related tasks help Help about any command server gotosocial server-related tasks - testrig gotosocial testrig-related tasks ``` -Under `Available Commands`, you can see the standard `server` command. But there are also commands doing admin and testing etc, which will be explained in this document. +Under `Available Commands`, you can see the standard `server` command. But there are also commands doing admin and debugging etc, which will be explained in this document. -**Please note -- for all of these commands, you will still need to set the global options correctly so that the CLI tool knows how eg., how to connect to your database, which database to use, which host and account domain to use etc.** +!!! Info "Passing global config to the CLI" + + For all of these commands, you will still need to set the global options correctly so that the CLI tool knows how to connect to your database, which database to use, which host and account domain to use, etc. + + You can set these options using environment variables, passing them as CLI flags (eg., `gotosocial [commands] --host example.org`), or by just pointing the CLI tool towards your config file (eg., `gotosocial --config-path ./config.yaml [commands]`). -You can set these options using environment variables, passing them as CLI flags (eg., `gotosocial [commands] --host example.org`), or by just pointing the CLI tool towards your config file (eg., `gotosocial --config-path ./config.yaml [commands]`). +!!! Info + + When running CLI commands, you'll get a bit of output like the following: + + ```text + time=XXXX level=info msg=connected to SQLITE database + time=XXXX level=info msg=there are no new migrations to run func=doMigration + time=XXXX level=info msg=closing db connection + ``` + + This is normal and indicates that the commands ran as expected. + +!!! Warning "Restarting GtS after running admin commands" + + Because of the way internal caching works in GoToSocial, you may need to restart GoToSocial after running some of these commands in order for the effect of the command to "take". We are still looking for a way to make this unnecessary. In the meantime, commands that require a restart after running the command are highlighted below. ## gotosocial admin @@ -68,7 +84,11 @@ gotosocial admin account create \ ### gotosocial admin account confirm -This command can be used to confirm a user+account on your instance, allowing them to log in and use the account. Note that if the account was created using `admin account create` this is not necessary. +This command can be used to confirm a user+account on your instance, allowing them to log in and use the account. + +!!! Info + + If the account was created using `admin account create` it is not necessary to run `confirm` on the account, it will be confirmed already. `gotosocial admin account confirm --help`: @@ -93,6 +113,10 @@ gotosocial admin account confirm --username some_username --config-path config.y This command can be used to promote a user to admin. +!!! Warning "Server restart required" + + In order for the change to "take", this command requires a restart of GoToSocial after running the command. + `gotosocial admin account promote --help`: ```text @@ -116,6 +140,10 @@ gotosocial admin account promote --username some_username --config-path config.y This command can be used to demote a user from admin to normal user. +!!! Warning "Server restart required" + + In order for the change to "take", this command requires a restart of GoToSocial after running the command. + `gotosocial admin account demote --help`: ```text @@ -139,10 +167,14 @@ gotosocial admin account demote --username some_username --config-path config.ya This command can be used to disable an account on your instance: prevent it from signing in or doing anything, without deleting data. +!!! Warning "Server restart required" + + In order for the change to "take", this command requires a restart of GoToSocial after running the command. + `gotosocial admin account disable --help`: ```text -prevent a local account from signing in or posting etc, but don't delete anything +set 'disabled' to true on a local account to prevent it from signing in or posting etc, but don't delete anything Usage: gotosocial admin account disable [flags] @@ -158,10 +190,41 @@ Example: gotosocial admin account disable --username some_username --config-path config.yaml ``` +### gotosocial admin account enable + +This command can be used to reenable an account on your instance, undoing a previous `disable` command. + +!!! Warning "Server restart required" + + In order for the change to "take", this command requires a restart of GoToSocial after running the command. + +`gotosocial admin account enable --help`: + +```text +undo a previous disable command by setting 'disabled' to false on a local account + +Usage: + gotosocial admin account enable [flags] + +Flags: + -h, --help help for enable + --username string the username to create/delete/etc +``` + +Example: + +```bash +gotosocial admin account enable --username some_username --config-path config.yaml +``` + ### gotosocial admin account password This command can be used to set a new password on the given local account. +!!! Warning "Server restart required" + + In order for the change to "take", this command requires a restart of GoToSocial after running the command. + `gotosocial admin account password --help`: ```text @@ -329,7 +392,11 @@ This command can be used to prune orphaned media from your GoToSocial. Orphaned media is defined as media that is in storage under a key that matches the format used by GoToSocial, but which does not have a corresponding database entry. This is useful for excising files that may be remaining from a previous installation, or files that were placed in storage mistakenly. -**This command only works when GoToSocial is not running, since it acquires an exclusive lock on storage. Stop GoToSocial first before running this command!** +!!! Warning "Requires a stopped server" + + This command only works when GoToSocial is not running, since it acquires an exclusive lock on storage. + + Stop GoToSocial first before running this command! ```text prune orphaned media from storage @@ -366,7 +433,11 @@ These items will be refetched later on demand, if necessary. Unused media means avatars/headers/status attachments which are not currently in use by an account or status. -**This command only works when GoToSocial is not running, since it acquires an exclusive lock on storage. Stop GoToSocial first before running this command!** +!!! Warning "Requires a stopped server" + + This command only works when GoToSocial is not running, since it acquires an exclusive lock on storage. + + Stop GoToSocial first before running this command! ```text prune unused/stale remote media from storage, older than given number of days diff --git a/docs/getting_started/user_creation.md b/docs/getting_started/user_creation.md index 806abf0fb..566df870f 100644 --- a/docs/getting_started/user_creation.md +++ b/docs/getting_started/user_creation.md @@ -2,10 +2,10 @@ Regardless of the installation method, you'll need to create some users. GoToSocial currently doesn't have a way for users to be created through the web UI, or for people to sign-up through the web UI. -Using the CLI, you can create a user: +In the meantime, you can create a user using the CLI: ```sh -$ gotosocial --config-path /path/to/config.yaml \ +./gotosocial --config-path /path/to/config.yaml \ admin account create \ --username some_username \ --email some_email@whatever.org \ @@ -17,29 +17,28 @@ In the above command, replace `some_username` with your desired username, `some_ If you want your user to have admin rights, you can promote them using a similar command: ```sh -$ gotosocial --config-path /path/to/config.yaml \ +./gotosocial --config-path /path/to/config.yaml \ admin account promote --username some_username ``` Replace `some_username` with the username of the account you just created. -!!! info - When running these commands, you'll get a bit of output like the following: +!!! warning "Promotion requires server restart" + + Due to the way caching works in GoToSocial, some admin CLI commands require a server restart after running the command in order for the changes to "take". + + For example, after promoting a user to admin, you will need to restart your GoToSocial server so that the new values can be loaded from the database. - ```text - time=XXXX level=info msg=connected to SQLITE database - time=XXXX level=info msg=there are no new migrations to run func=doMigration - time=XXXX level=info msg=closing db connection - ``` - - This is normal and indicates that the commands ran as expected. +!!! tip + + Take a look at the other available CLI commands [here](../admin/cli.md). ## Containers -When running GoToSocial from a container, you'll need to execute the above command in the conatiner instead. How to do this varies based on your container runtime, but for Docker it should look like: +When running GoToSocial from a container, you'll need to execute the above command in the container instead. How to do this varies based on your container runtime, but for Docker it should look like: ```sh -$ docker exec -it CONTAINER_NAME_OR_ID \ +docker exec -it CONTAINER_NAME_OR_ID \ /gotosocial/gotosocial \ admin account create \ --username some_username \