Ambas as imagens são configuradas através de variáveis de ambiente. Os nomes da API usam um duplo
underscore entre níveis, como Smtp__Host. Uma definição omitida mantém o seu valor
predefinido. Os kits iniciais de Alojamento com Docker,
Alojamento no Kubernetes e Alojamento no AKS já
definem tudo o que uma instalação normal precisa; esta página serve para alterar uma, ou para uma
configuração própria (Executar as imagens).
API: bases de dados
Definição
O que faz
ConnectionStrings__DefaultConnection
A base de dados onde vivem os dados do espaço de trabalho predefinido, como Host=postgres;Database=omnicore-db;Username=archestack;Password=.... Obrigatória.
ConnectionStrings__Core
Os metadados do espaço de trabalho predefinido: entidades, páginas, scripts. Base de dados omnicore-core. Obrigatória.
ConnectionStrings__Identity
Utilizadores, espaços de trabalho e chaves, partilhados por todos os espaços de trabalho. Base de dados omnicore-identity. Obrigatória.
ConnectionStrings__Keycloak
Só ao migrar utilizadores a partir do Keycloak. Caso contrário, deixe-a vazia.
ConnectionStrings__Cluster
Como várias instâncias da API se avisam umas às outras de alterações. Por predefinição, a base de dados identity; defina-a para o próprio PostgreSQL quando houver um connection pooler como o PgBouncer pelo meio.
Database__CreateMissing
true cria a base de dados dos dados quando falta; as outras duas são criadas de qualquer forma. Predefinição false; os kits definem true.
O utilizador nestas strings precisa do direito de criar bases de dados: cada novo espaço de trabalho
recebe duas próprias, com nomes derivados dos nomes base acima.
API: endereços
Definição
O que faz
ASPNETCORE_URLS
Onde a API escuta dentro do contentor: http://+:8080.
ASPNETCORE_ENVIRONMENT
Sempre Production. Qualquer outro valor mostra detalhes dos erros a qualquer pessoa.
Http__PathBase
O caminho sob o qual a API é servida, como /archestack. Vazio na raiz.
Identity__AppBaseUrl
O endereço do builder, como https://apps.example.com/archestack. As ligações de convite e de reposição de palavra-passe apontam para aqui.
ForwardedHeaders__TrustedProxies
Os endereços dos proxies à frente, cujo X-Forwarded-For é aceite. A predefinição cobre as redes privadas; sem o valor certo, todos os visitantes parecem ser o proxy e partilham um só rate limit.
Tenancy__HostSuffix
Serve cada espaço de trabalho num hostname próprio, <label>.<suffix>, e permite aos espaços de trabalho acrescentar domínios próprios. Vazio por predefinição.
API: início de sessão
Definição
O que faz
Identity__Provider
Builtin: o Archestack inicia a sessão das pessoas por si. Predefinição.
O primeiro admin, criado no primeiro arranque quando ainda não há nenhum utilizador. Usadas uma só vez: depois altere a palavra-passe no Archestack. Omita ambas para criar o admin no builder.
Identity__AllowCompanySignup
true permite a qualquer pessoa criar uma empresa própria em /register. Predefinição false. Os admins de uma empresa podem correr scripts no servidor, por isso deixe-a desligada, a menos que gira um serviço público.
Identity__AccessTokenMinutes
Quanto tempo dura um token de sessão antes de ser renovado. Predefinição 15.
Identity__RefreshTokenDays
Quanto tempo uma pessoa fica com a sessão iniciada sem usar o Archestack. Predefinição 30.
Depois deste número de palavras-passe erradas, uma conta fica bloqueada durante este tempo. Predefinições 10 e 15.
API: email
Definição
O que faz
Smtp__Host, Smtp__Port, Smtp__UseSsl
O servidor de email para convites e reposições de palavra-passe. Porta 587 e SSL por predefinição. Sem host, o admin que envia um convite recebe a ligação para a passar.
Smtp__Username, Smtp__Password
As credenciais de acesso ao servidor de email.
Smtp__From, Smtp__FromName
O remetente que esses emails mostram.
O email que as aplicações enviam passa pelas contas de email que cada espaço de trabalho configura no seu builder.
API: ficheiros e backups
Definição
O que faz
Files__Directory
Para onde vão os uploads e os ficheiros dos espaços de trabalho, como /files. Ponha lá um volume: num contentor sem volume, os ficheiros perdem-se na próxima atualização.
Files__MaxFileBytes
O maior ficheiro individual. Predefinição 100 MB.
Files__MaxWorkspaceBytes
Quanto um espaço de trabalho pode guardar. Predefinição 0, sem limite.
Backup__Directory
Para onde vão os backups, como /backups. Também um volume, e copie o que lá chega para outro sítio.
Backup__RetentionDays
Quanto tempo os backups são guardados. Predefinição 30.
Backup__CronSchedule
Quando corre o backup noturno, como cron do Quartz. Predefinição 0 0 3 * * ?, às 03:00.
API: escala e limites
Definição
O que faz
Realtime__EntityChanges
false impede que os ecrãs se atualizem quando um registo muda noutro lado. Predefinição true. Desligado, uma instalação serve muito mais pessoas em simultâneo; consulte Capacidade e dimensionamento.
Cluster__Enabled
Permite que várias instâncias da API trabalhem como uma só. Predefinição true; deixe-a ligada.
RateLimiting__Enabled
Limites de pedidos por chamador. Predefinição true. Os limites aplicam-se por instância da API.
RateLimiting__PermitsPerMinute
Pedidos que uma pessoa pode fazer por minuto. Predefinição 2000.
RateLimiting__AuthPermitsPerMinute
Tentativas de início de sessão por minuto a partir de um endereço. Predefinição 20.
RateLimiting__PublicPagePermitsPerMinute
O que um visitante sem conta pode pedir às páginas públicas por minuto. Predefinição 240.
Scripting__TypedData__Enabled
As Business Entities como conjuntos tipados nos scripts (Db.Order). Predefinição true.
Um certificado que protege as chaves com que as palavras-passe guardadas são cifradas. Sem ele, essas chaves ficam desprotegidas na base de dados identity, por isso uma cópia dessa base de dados contém as duas metades.
Um só par de chaves para as notificações do browser em todos os espaços de trabalho. Se for omitido, cada espaço de trabalho cria o seu. Nunca o altere depois de as pessoas terem permitido notificações: as suas subscrições deixam de funcionar.
API: monitorização
Definição
O que faz
Observability__Enabled
Envia traces, métricas e logs por OpenTelemetry. Predefinição false.
O endereço da API tal como o browser a alcança, como https://api.example.com. Vazio quando a API está no mesmo endereço em /api.
BASE_PATH
O caminho sob o qual é servida, como /archestack. Vazio na raiz.
VITE_UI_MODE
dashboard mostra o builder em / e a aplicação publicada em /app. kiosk mostra a aplicação publicada em /, para um endereço que é só a aplicação.
VITE_DASHBOARD_URL
Com kiosk, o endereço do builder quando está noutro hostname.
VITE_APP_URL
Com dashboard, o endereço da aplicação publicada quando está noutro hostname.
API_INTERNAL_URL
O endereço da API dentro da rede, como http://api:8080. As pré-visualizações de ligações nas aplicações de chat e as páginas que os motores de busca leem vêm daí. No Kubernetes, escreva o nome completo do service, http://<service>.<namespace>.svc.cluster.local:8080.
A imagem PostgreSQL
Definição
O que faz
POSTGRES_USER, POSTGRES_PASSWORD
O utilizador com que a API se liga. A palavra-passe é definida quando o PostgreSQL arranca pela primeira vez num disco vazio; alterar a variável depois não a altera na base de dados.
POSTGRES_DB
postgres. A API cria as suas próprias bases de dados.
PGDATA
Só num disco novo cuja raiz contém lost+found, como no Kubernetes: uma pasta abaixo do ponto de montagem, como /var/lib/postgresql/data/pgdata.
Dê ao contentor 1 GB de memória partilhada, como explica Executar as imagens.
Cookies
Usamos cookies para melhorar a tua experiência neste site.