Ustawienia obrazów - Archestack Learn

Oba obrazy konfiguruje się przez zmienne środowiskowe. Nazwy w API używają podwójnego podkreślenia między poziomami, na przykład Smtp__Host. Pominięte ustawienie zachowuje wartość domyślną. Zestawy startowe ze stron Hosting z Dockerem, Hosting na Kubernetesie i Hosting na AKS już ustawiają wszystko, czego potrzebuje zwykła instalacja; ta strona służy do zmiany jednego z ustawień albo do własnej konfiguracji (Uruchamianie obrazów).

API: bazy danych

Ustawienie	Co robi
`ConnectionStrings__DefaultConnection`	Baza danych z danymi domyślnej przestrzeni roboczej, na przykład `Host=postgres;Database=omnicore-db;Username=archestack;Password=...`. Wymagane.
`ConnectionStrings__Core`	Metadane domyślnej przestrzeni roboczej: encje, strony, skrypty. Baza danych `omnicore-core`. Wymagane.
`ConnectionStrings__Identity`	Użytkownicy, przestrzenie robocze i klucze, wspólne dla wszystkich przestrzeni roboczych. Baza danych `omnicore-identity`. Wymagane.
`ConnectionStrings__Keycloak`	Tylko przy przenoszeniu użytkowników z Keycloak. W przeciwnym razie zostaw puste.
`ConnectionStrings__Cluster`	Jak kilka instancji API informuje się nawzajem o zmianach. Domyślnie baza danych identity; ustaw je na sam PostgreSQL, gdy pomiędzy jest connection pooler, taki jak PgBouncer.
`Database__CreateMissing`	`true` tworzy bazę danych z danymi, gdy jej brakuje; dwie pozostałe są tworzone w każdym przypadku. Domyślnie `false`; zestawy ustawiają `true`.

Użytkownik w tych ciągach potrzebuje prawa do tworzenia baz danych: każda nowa przestrzeń robocza dostaje dwie własne, nazwane według powyższych nazw bazowych.

API: adresy

Ustawienie	Co robi
`ASPNETCORE_URLS`	Gdzie API nasłuchuje wewnątrz kontenera: `http://+:8080`.
`ASPNETCORE_ENVIRONMENT`	Zawsze `Production`. Każda inna wartość pokazuje szczegóły błędów każdemu.
`Http__PathBase`	Ścieżka, pod którą działa API, na przykład `/archestack`. Puste w katalogu głównym.
`Identity__AppBaseUrl`	Adres buildera, na przykład `https://apps.example.com/archestack`. Tu prowadzą linki z zaproszeń i resetowania hasła.
`ForwardedHeaders__TrustedProxies`	Adresy proxy z przodu, których nagłówkowi `X-Forwarded-For` się ufa. Wartość domyślna obejmuje sieci prywatne; bez właściwej każdy odwiedzający wygląda jak proxy i dzieli z innymi jeden limit żądań.
`Tenancy__HostSuffix`	Udostępnia każdą przestrzeń roboczą pod własną nazwą hosta, `<label>.<suffix>`, i pozwala przestrzeniom roboczym dodawać własne domeny. Domyślnie puste.

Ustawienie	Co robi
`Identity__Provider`	`Builtin`: Archestack sam loguje użytkowników. Domyślnie.
`Identity__InitialAdminEmail`, `Identity__InitialAdminPassword`	Pierwszy administrator, tworzony przy pierwszym starcie, gdy nie ma jeszcze żadnego użytkownika. Używane raz: potem zmień hasło w Archestack. Pomiń oba, aby zamiast tego utworzyć administratora w builderze.
`Identity__AllowCompanySignup`	`true` pozwala każdemu utworzyć własną firmę pod `/register`. Domyślnie `false`. Administratorzy firmy mogą uruchamiać skrypty na serwerze, więc zostaw to wyłączone, chyba że prowadzisz publiczną usługę.
`Identity__AccessTokenMinutes`	Jak długo token logowania jest ważny, zanim zostanie odnowiony. Domyślnie 15.
`Identity__RefreshTokenDays`	Jak długo ktoś pozostaje zalogowany, nie korzystając z Archestack. Domyślnie 30.
`Identity__MinimumPasswordLength`	Domyślnie 8.
`Identity__MaxFailedLogins`, `Identity__LockoutMinutes`	Po tylu błędnych hasłach konto jest blokowane na tyle minut. Domyślnie 10 i 15.

API: poczta

Ustawienie	Co robi
`Smtp__Host`, `Smtp__Port`, `Smtp__UseSsl`	Serwer pocztowy dla zaproszeń i resetowania haseł. Domyślnie port 587 i SSL. Bez hosta administrator, który wysyła zaproszenie, dostaje link do przekazania.
`Smtp__Username`, `Smtp__Password`	Dane logowania do serwera pocztowego.
`Smtp__From`, `Smtp__FromName`	Nadawca, którego pokazują te wiadomości.

Poczta wysyłana przez aplikacje idzie przez konta pocztowe, które każda przestrzeń robocza konfiguruje w swoim builderze.

API: pliki i kopie zapasowe

Ustawienie	Co robi
`Files__Directory`	Gdzie trafiają przesłane pliki i pliki przestrzeni roboczych, na przykład `/files`. Podłącz tam wolumin: w kontenerze bez niego pliki giną przy następnej aktualizacji.
`Files__MaxFileBytes`	Największy pojedynczy plik. Domyślnie 100 MB.
`Files__MaxWorkspaceBytes`	Ile może przechowywać jedna przestrzeń robocza. Domyślnie 0, bez limitu.
`Backup__Directory`	Gdzie trafiają kopie zapasowe, na przykład `/backups`. To też wolumin, a to, co tam trafia, kopiuj w inne miejsce.
`Backup__RetentionDays`	Jak długo przechowywane są kopie zapasowe. Domyślnie 30.
`Backup__CronSchedule`	Kiedy uruchamia się nocna kopia zapasowa, jako cron Quartz. Domyślnie `0 0 3 * * ?`, czyli 03:00.

API: skala i limity

Ustawienie	Co robi
`Realtime__EntityChanges`	`false` sprawia, że ekrany nie odświeżają się, gdy rekord zmienia się gdzie indziej. Domyślnie `true`. Po wyłączeniu jedna instalacja obsługuje jednocześnie znacznie więcej osób; zobacz Wydajność i dobór serwerów.
`Cluster__Enabled`	Pozwala kilku instancjom API działać jak jedna. Domyślnie `true`; zostaw włączone.
`RateLimiting__Enabled`	Limity żądań na wywołującego. Domyślnie `true`. Limity obowiązują na każdą instancję API osobno.
`RateLimiting__PermitsPerMinute`	Liczba żądań, które jedna osoba może wysłać na minutę. Domyślnie 2000.
`RateLimiting__AuthPermitsPerMinute`	Próby logowania na minutę z jednego adresu. Domyślnie 20.
`RateLimiting__PublicPagePermitsPerMinute`	Ile odwiedzający bez konta może na minutę żądać od stron publicznych. Domyślnie 240.
`Scripting__TypedData__Enabled`	Business Entities jako typowane zbiory w skryptach (`Db.Order`). Domyślnie `true`.

API: klucze

Ustawienie	Co robi
`DataProtection__CertificatePath`, `DataProtection__CertificatePassword`	Certyfikat chroniący klucze, którymi szyfrowane są przechowywane hasła. Bez niego te klucze leżą niezabezpieczone w bazie danych identity, więc kopia tej bazy zawiera obie połowy.
`Push__VapidPublicKey`, `Push__VapidPrivateKey`, `Push__Subject`	Jedna para kluczy do powiadomień w przeglądarce dla wszystkich przestrzeni roboczych. Jeśli ją pominiesz, każda przestrzeń robocza tworzy własną. Nigdy jej nie zmieniaj, gdy użytkownicy zezwolili już na powiadomienia: ich subskrypcje przestaną działać.

API: monitoring

Ustawienie	Co robi
`Observability__Enabled`	Wysyła ślady, metryki i logi przez OpenTelemetry. Domyślnie `false`.
`Observability__OtlpEndpoint`	Dokąd, na przykład `http://otel-collector:4317`.
`Observability__Instance`, `Observability__Environment`	Nazwa tej instalacji na dashboardach.

Obraz web

Ustawienie	Co robi
`VITE_API_URL`	Adres API, pod którym osiąga je przeglądarka, na przykład `https://api.example.com`. Puste, gdy API jest pod tym samym adresem pod `/api`.
`BASE_PATH`	Ścieżka, pod którą działa obraz, na przykład `/archestack`. Puste w katalogu głównym.
`VITE_UI_MODE`	`dashboard` pokazuje builder pod `/`, a opublikowaną aplikację pod `/app`. `kiosk` pokazuje opublikowaną aplikację pod `/`, dla adresu, który jest tylko aplikacją.
`VITE_DASHBOARD_URL`	Przy `kiosk` adres buildera, gdy jest pod inną nazwą hosta.
`VITE_APP_URL`	Przy `dashboard` adres opublikowanej aplikacji, gdy jest pod inną nazwą hosta.
`API_INTERNAL_URL`	Adres API wewnątrz sieci, na przykład `http://api:8080`. Z niego pochodzą podglądy linków w komunikatorach i strony czytane przez wyszukiwarki. W Kubernetesie wpisz pełną nazwę usługi, `http://<service>.<namespace>.svc.cluster.local:8080`.

Obraz PostgreSQL

Ustawienie	Co robi
`POSTGRES_USER`, `POSTGRES_PASSWORD`	Użytkownik, jako który łączy się API. Hasło jest ustawiane przy pierwszym starcie PostgreSQL na pustym dysku; późniejsza zmiana zmiennej nie zmienia go w bazie danych.
`POSTGRES_DB`	`postgres`. API samo tworzy swoje bazy danych.
`PGDATA`	Tylko na nowym dysku, którego katalog główny zawiera `lost+found`, jak w Kubernetesie: folder poniżej punktu montowania, na przykład `/var/lib/postgresql/data/pgdata`.

Daj kontenerowi 1 GB pamięci współdzielonej, jak wyjaśnia strona Uruchamianie obrazów.