SSH & WP-CLI

Varje Templ-hemsida inkluderar full SSH-åtkomst till sin container. När du är ansluten kan du hantera WordPress med WP-CLI, driftsätta med git, installera paket med composer och kontrollera containern med Templ CLI.

Anslut över SSH

Det enklaste sättet att öppna ett skal är direkt i din webbläsare: navigera till hemsidan i Templ-panelen, klicka på knappen Connect längst upp till höger och klicka sedan på Open SSH.

För att ansluta från din egen terminal, öppna hemsidans flik Översikt och kopiera det färdiga kommandot under SFTP/SSH → SSH Tools → SSH Command, autentisera sedan med antingen ett Lösenord eller SSH-nycklar.

Om du ansluter ofta, byt SSH Tools till SSH Config och lägg till det genererade blocket i din ~/.ssh/config. Det definierar ett alias (din webbplats domän) med värd, port och användare ifyllda, så du kan ansluta med bara ssh <din-domän> istället för det fullständiga kommandot.

Förinstallerade verktyg

Följande verktyg är tillgängliga i varje hemsidas container och redo att användas över SSH:

WP-CLI

WP-CLI är förinstallerat och låter dig hantera WordPress från kommandoraden. Byt först till din hemsidas webroot, kör sedan vilket wp-kommando som helst:

cd ~/app_xxxx
wp plugin list

Några vanligt använda kommandon:

wp plugin list                          # lista installerade plugins och deras status
wp core update --minor                  # uppdatera core till senaste minor/säkerhetsutgåvan
wp search-replace old.com new.com       # uppdatera URLer, t.ex. efter en Migrering
wp cache flush                          # rensa WordPress objektcache

För att köra ett WP-CLI-kommando automatiskt enligt ett schema, se Anpassade cron-jobb.

Inaktivera plugins

Inaktivera en enskild plugin med dess slug, eller alla plugins på en gång - användbart när en plugin förstör webbplatsen eller låser ute dig från WP Admin:

wp plugin deactivate <slug>       # inaktivera en plugin
wp plugin deactivate --all        # inaktivera alla plugins

Om webbplatsen visar ett kritiskt fel orsakat av en plugin eller ett tema, lägg till --skip-plugins --skip-themes så att kommandot körs även när en plugin eller tema har fatala fel som annars skulle hindra WP-CLI från att laddas:

wp plugin deactivate <slug> --skip-plugins --skip-themes

Återaktivera en plugin på samma sätt med wp plugin activate <slug>.

För att inaktivera en enskild plugin eller alla utan kommandoraden kan du också använda panelens Inaktivera plugins-verktyg.

Rulla tillbaka en plugin till en äldre version

Om en plugin-uppdatering förstörde webbplatsen, installera om den tidigare versionen:

wp plugin install <slug> --version=<version> --force

Detta fungerar för plugins som är värd på wordpress.org. Nedgradering ersätter endast filer, så det kommer inte ångra databasändringar som den nyare versionen redan gjort.

Återställ en användares Lösenord

Om du är utelåst från WP Admin och inte kan ta emot återställningsmejlet, ange ett nytt Lösenord direkt:

wp user update <email> --user_pass='<new password>'

Node.js

Flera Node.js-versioner är förinstallerade och hanteras med versionshanteraren n. Lista de versioner som är tillgängliga på din container:

n ls

För att använda en specifik version, lägg till den i början av din PATH i ~/.bashrc så att valet kvarstår mellan sessioner:

PATH=/usr/local/n/versions/node/<version>/bin:$PATH

Starta om din SSH-session för att ändringen ska träda i kraft, bekräfta sedan att den avsedda versionen är aktiv:

node -v

Templ CLI

Kommandot templ är Templ Container CLI för att kontrollera din container. Kör templ på egen hand för att se de tillgängliga kommandona:

Usage: templ [options] [command]

Templ Container CLI

Options:
  -v,--verbose  Verbose output
  -s,--silent   No/minimal output
  -d,--debug    Debug output
  -h, --help    display help for command

Commands:
  version       Prints version.
  php           php related commands
  cache         cache related commands
  incident      Incident commands
  service       service related commands

De två du oftast kommer att använda:

templ php restart     # starta om PHP för din hemsida
templ cache purge     # rensa Templ Cache

Köra Templ CLI på distans

Genvägen templ fungerar endast inifrån en SSH-session på din container. För att köra ett kommando på distans i en rad, utan att öppna en interaktiv session, anropa den fullständiga sökvägen till binärfilen istället:

ssh -p <PORT> <USER>@<IPADDR> /usr/bin/templ-ccli cache purge

Detta är användbart för automatisering, till exempel att rensa cachen från ett driftsättningsskript.