Configurações¶

Esta página explica cada seção da página Configurações e o arquivo de configuração.

Para abrir a página, pressione ⚙ Configurações na barra superior. A página tem estas seções, de cima para baixo:

Credenciais
Fontes de conjuntos de dados
Versões dos conjuntos de dados e dados locais (com Visualizações de mapa dentro dela)
Memória

O seletor de idioma não está na página Configurações. Ele está na barra superior. Consulte Idioma.

Credenciais¶

A seção Credenciais tem um cartão para cada credencial:

Título do cartão	Credencial	Campos do cartão
AWS (conjuntos de dados S3)	Um par de chaves da AWS. Todas as fontes de dados S3 usam este único par de chaves.	ID da chave de acesso, Chave de acesso secreta
Planet	A chave do mapa base Planet	Nome de usuário, Chave de API
Google Maps	A chave do mapa base Google Maps	Chave de API
Copernicus (CDSE)	O ID da instância do mapa base Copernicus (CDSE)	ID da instância

Cada cartão tem uma linha Em uso a partir de: que informa de onde vem a credencial em uso. Os valores possíveis são Ambiente, Segredo do Docker, Gerenciador de Credenciais, Armazenamento criptografado e Não definida.

Um cartão com um campo secreto (Chave de acesso secreta ou Chave de API) também mostra Salvo ou Não salvo. O campo secreto fica sempre vazio, também depois que você salva. O aplicativo nunca envia um segredo salvo de volta para o navegador.

Os campos ID da chave de acesso, Nome de usuário e ID da instância não são segredos. Estes campos mostram o valor que o armazenamento criptografado guarda.

Onde obter cada valor¶

AWS (conjuntos de dados S3): obtenha um ID da chave de acesso e uma chave de acesso secreta de uma conta da AWS que você controla. A conta da AWS paga todas as leituras de conjuntos de dados. Consulte Fontes de conjuntos de dados.
Planet: obtenha a chave de API e o nome de usuário na sua conta Planet.
Google Maps: obtenha uma chave de API para os blocos de mapa do Google Maps na sua conta Google.
Copernicus (CDSE): obtenha o ID da instância no seu painel do Copernicus Data Space. O ID da instância tem de 8 a 64 caracteres: somente letras, dígitos e hifens.

Adicionar ou alterar uma chave da AWS¶

No cartão AWS (conjuntos de dados S3), digite o ID da chave em ID da chave de acesso.
Digite o segredo em Chave de acesso secreta.
Pressione Verificar credenciais.
Verifique se a linha de resultado começa com "A chave" e diz "é válida".
Pressione Salvar.

NOTA: Verificar credenciais é gratuito. Ele pergunta ao AWS STS somente se o par de chaves é válido. Ele não lê um bucket.

NOTA: Você não pode pressionar Salvar até que o par de chaves passe em Verificar credenciais. Se você alterar um campo depois da verificação, você deve fazer a verificação novamente. O aplicativo mostra "Verifique as credenciais primeiro. Um par de chaves que falhou na verificação nunca é salvo."

Para verificar a chave da AWS que está em uso agora, deixe Chave de acesso secreta vazia e não altere ID da chave de acesso. Depois, pressione Verificar credenciais. Se você digitar somente um dos dois valores, o aplicativo mostra "Informe o ID da chave de acesso e a chave de acesso secreta, ou nenhum dos dois."

Resultados de Verificar credenciais¶

Resultado	O que ele informa	O que fazer
"A chave ... é válida: ..."	A AWS aceitou o par de chaves. A linha mostra uma parte da chave, a identidade AWS e os 4 últimos dígitos da conta da AWS.	Pressione Salvar se você digitou um novo par.
"A AWS rejeitou esta credencial ..."	O ID da chave ou o segredo está errado, ou a chave não está ativa.	Digite os dois valores novamente e depois pressione Verificar credenciais.
"Nenhuma credencial da AWS foi informada ou salva."	Nenhum par de chaves foi digitado ou salvo.	Digite o ID da chave e o segredo.
"Existe uma credencial salva, mas ela não pôde ser lida ..."	O aplicativo não consegue descriptografar a chave salva com a chave mestra ativa.	Digite o ID da chave e o segredo novamente e depois salve.
"Não foi possível alcançar o AWS STS ..."	Um problema de rede ou de endpoint. O resultado não informa nada sobre a credencial.	Faça a verificação novamente.
"O AWS STS não respondeu a tempo."	A verificação parou depois do tempo limite. O resultado não informa nada sobre a credencial.	Faça a verificação novamente.
"A AWS respondeu ..."	A AWS enviou um código de erro diferente. A linha mostra o código.	Examine o código.

Adicionar ou alterar uma chave de mapa base¶

No cartão Planet, Google Maps ou Copernicus (CDSE), digite o valor. Para Planet, digite o Nome de usuário e a Chave de API.
Pressione Testar conexão.
Verifique se o resultado começa com "Conexão bem-sucedida."
Pressione Salvar.

NOTA: Testar conexão envia os valores digitados ao provedor, mas não os salva. Você não pode pressionar Salvar até que um teste dos mesmos valores tenha sucesso. O aplicativo mostra "Teste a conexão primeiro. Uma conexão com falha nunca é salva."

Para testar a chave que está em uso agora, deixe o cartão vazio. Depois, pressione Testar conexão. O resultado é um destes:

A fonte que o aplicativo testou. Um exemplo é "Foi testada a credencial em uso (Ambiente); nada foi digitado neste cartão."
Se o cartão não tiver valor guardado: "Nada a testar: este cartão está vazio e nada está armazenado para ele."

Resultados de Testar conexão para um mapa base¶

Um teste com sucesso começa com "Conexão bem-sucedida." Um teste com falha começa com "Falha na conexão:". A razão vem depois.

Resultado	O que ele informa
ok: "O provedor aceitou esta credencial."	A chave está correta.
não autorizado: "O provedor rejeitou esta credencial. ..."	O valor está errado, ou ele não tem permissão agora.
inacessível: "Não foi possível alcançar o provedor ..."	Um problema de rede ou de endpoint. Ele não informa nada sobre a credencial.
tempo esgotado: "O provedor não respondeu dentro do tempo permitido. ..."	O provedor foi lento demais, ou o aplicativo não consegue chegar até ele. Ele não informa nada sobre a credencial.
mal configurado: "O provedor está mal configurado no servidor, ..."	A configuração do servidor para este provedor tem um problema. O aplicativo não testou a credencial.
não configurado: "Nenhuma credencial está disponível para testar."	Nenhuma credencial foi encontrada.

Onde o aplicativo guarda as credenciais¶

O aplicativo procura cada credencial em 4 lugares, nesta sequência. Ele usa o primeiro que encontrar:

Ambiente: variáveis de ambiente. Os nomes são AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY (e um AWS_SESSION_TOKEN opcional), PLANET_API_KEY (como user:key), GOOGLE_MAPS_API_KEY e CDSE_INSTANCE_ID.
Segredo do Docker: um arquivo com o mesmo nome na pasta de segredos do Docker. A pasta padrão é /run/secrets.
Gerenciador de Credenciais: o Gerenciador de Credenciais do Windows. As chaves de configuração security.credential_manager_names e security.credential_manager_pairs informam os nomes de destino.
Armazenamento criptografado: as credenciais que você salva na página Configurações.

O armazenamento criptografado guarda um arquivo para cada credencial (<name>.enc.json) na pasta que security.secret_store_dir informa. O padrão é ./data/secrets.d, relativo à pasta do arquivo de configuração. Na imagem Docker, esta pasta é /data/data/secrets.d.

Uma chave mestra criptografa o armazenamento. Para ver de onde vem a chave mestra, abra Detalhes na seção Credenciais. Se a chave mestra for um arquivo na mesma árvore de pastas das credenciais salvas, o aplicativo mostra um aviso. Então qualquer pessoa que possa ler essa pasta pode descriptografar as credenciais.

AVISO: Se a chave mestra for um arquivo ao lado dos dados, forneça a chave por meio de LUC_ANALYTICS_SECRET_KEY (uma variável de ambiente ou um segredo do Docker). Uma pessoa que pode ler o arquivo da chave pode ler as suas credenciais salvas.

Remover uma credencial salva¶

NOTA: Este procedimento remove a credencial somente do armazenamento criptografado. Ele não remove uma variável de ambiente, um segredo do Docker nem um valor no Gerenciador de Credenciais do Windows. Você deve remover esses itens na fonte deles.

Na seção Credenciais, abra Detalhes.
Encontre a linha da credencial. A coluna Armazenamento criptografado mostra Salva, ou Salva, não está em uso (uma fonte acima tem prioridade).
Pressione Excluir salva.
Leia a mensagem e depois pressione OK.
Verifique se o aplicativo mostra "Credencial salva excluída."

CUIDADO: Você não pode desfazer uma exclusão. Para usar a credencial novamente, digite-a e salve-a novamente.

Fontes de conjuntos de dados¶

A seção Fontes de conjuntos de dados informa ao aplicativo onde ler cada um dos 6 conjuntos de dados: Área do pixel, Florestas naturais SBTN, Cobertura florestal global JRC 2020, Alertas de perturbação, Fatores da perda de cobertura arbórea e Ano da perda de cobertura arbórea.

Privacidade e custo de ler o bucket do WRI¶

A seção começa com o aviso Privacidade e custo de ler o bucket do WRI. O aviso informa estes fatos:

O WRI é a fonte dos conjuntos de dados. O aviso tem um link para a página do WRI Data Explorer.
Quando o aplicativo lê um conjunto de dados do bucket S3 do WRI, o WRI registra a solicitação nos logs de armazenamento dele. Os logs mostram as partes do conjunto de dados que o aplicativo solicitou. Portanto, os logs podem mostrar as áreas que você analisa. O aplicativo nunca envia as formas dos seus locais.
O bucket do WRI usa pagamento pelo solicitante. Cada solicitação e cada byte que o aplicativo transfere são cobrados na sua conta da AWS. Isso inclui cada download.

AVISO: Todas as leituras de dados do bucket do WRI geram uma cobrança na sua conta da AWS. O aplicativo informa o custo como aproximadamente $0.09 por GB para um computador fora da AWS, mais uma pequena taxa por leitura. Estes são preços de tabela da AWS e podem mudar.

Para evitar estas leituras, baixe uma cópia de cada conjunto de dados para este computador. Depois do download, as análises não leem nada do WRI.

Cartões dos conjuntos de dados¶

Cada conjunto de dados tem um cartão. O cartão mostra uma linha Em uso:, uma palavra de status e um botão Alterar. A linha Em uso: informa o que o conjunto de dados lê agora, por exemplo "Em uso: WRI online, a mais recente — cobrado por análise". A palavra de status é Atualizado, Versão mais recente disponível, Não verificado ou Baixando….

Pressione Ver versões para ir para as versões desse conjunto de dados em Versões dos conjuntos de dados e dados locais.

Alterar a fonte de um conjunto de dados¶

Quando você pressiona Alterar, uma caixa de diálogo abre. A primeira etapa pergunta "De onde deve vir conjunto de dados?". Você pode selecionar uma de 3 opções:

Opção	O que ela faz
WRI online, sempre a mais recente	Cada análise lê o conjunto de dados do bucket do WRI. Cada análise gera uma cobrança na sua conta da AWS.
Baixar uma cópia para este computador	O aplicativo baixa uma cópia. Você paga uma vez pela transferência. Depois, as análises leem a cópia sem custo.
Uma pasta que já tenho (avançado)	O aplicativo lê uma pasta zarr que já está neste computador. Ele nunca grava nessa pasta.

O aplicativo mostra Recomendado ao lado da opção que corresponde à frequência com que o conjunto de dados muda. O aplicativo não altera a fonte sozinho.

Se nenhuma chave da AWS passou na verificação, a caixa de diálogo adiciona a etapa Adicione sua chave da AWS. Digite o ID da chave de acesso e a Chave de acesso secreta e depois pressione Verificar esta chave. Você não pode pressionar Avançar até que a chave passe na verificação.

Nada muda até que você pressione o último botão da caixa de diálogo. Para parar, pressione Cancelar, pressione × ou pressione a tecla Esc.

Baixar uma cópia para este computador¶

AVISO: Um download gera uma cobrança na sua conta da AWS pela transferência de dados. Verifique se você aceita o custo antes de pressionar Iniciar download.

No cartão do conjunto de dados, pressione Alterar.
Selecione Baixar uma cópia para este computador.
Pressione Avançar.
Se a caixa de diálogo perguntar "Qual versão de conjunto de dados?", selecione Mais recente (precisa ser baixada) ou uma cópia que já está neste computador.
Pressione Avançar.
Se a caixa de diálogo pedir uma chave da AWS, digite a chave e pressione Verificar esta chave. Depois, pressione Avançar.
Em Destino, digite uma pasta ou pressione Procurar… para selecionar uma pasta. Consulte O navegador de pastas.
Verifique se a caixa de diálogo não mostra "Não há espaço livre suficiente para este conjunto de dados."
Pressione Avançar.
Marque a caixa Entendo que minha conta da AWS é cobrada por este download.
Pressione Iniciar download.

Se você selecionar uma cópia que já está neste computador, a caixa de diálogo pergunta "Usar a cópia de data?". Pressione Usar esta cópia. Isso não faz nenhuma solicitação e não custa nada.

Até que o download esteja concluído, as análises continuam a ler o conjunto de dados do WRI online. Quando o download está concluído, o conjunto de dados lê a cópia local.

Enquanto um download está em andamento, o cartão mostra Pausar, Retomar e Parar. Pausar mantém os arquivos que chegaram. Parar pergunta a você primeiro. Se você pressionar Parar e descartar, o aplicativo exclui a cópia parcial, e o próximo download começa novamente sem arquivos. Pressione Continuar baixando para continuar.

O navegador de pastas¶

Os campos Destino e Pasta têm uma caixa de texto e um botão Procurar…. Você pode digitar um caminho de pasta completo na caixa de texto.

Pressione Procurar…. O navegador mostra as Raízes de download aprovadas.
Selecione uma pasta para abri-la.
Para subir um nível, pressione Subir.
Quando o navegador mostrar a pasta correta, pressione Usar esta pasta.
Para fechar o navegador sem alteração, pressione Fechar navegador.

O navegador mostra somente pastas. Ele nunca mostra arquivos nem pastas fora de uma raiz aprovada.

Os downloads vão somente para as pastas em datasets.download_roots no arquivo de configuração. Na imagem Docker, a raiz de download padrão é /data/datasets. Se nenhuma raiz de download estiver configurada, o navegador mostra "Nenhuma raiz de download está configurada neste servidor (datasets.download_roots), então nada pode ser navegado ou baixado."

Para Uma pasta que já tenho (avançado), o navegador também mostra as pastas em datasets.browse_roots com o rótulo "(somente leitura)". Você também pode digitar uma pasta fora das raízes. O aplicativo então lê a pasta, mas nunca grava nela.

Em um servidor no WSL, o aplicativo lê um caminho do Windows como D:\data como /mnt/d/data. Se essa unidade não estiver montada, o aplicativo mostra "Essa unidade não está disponível neste servidor (não está montada)."

O cabeçalho de Fontes de conjuntos de dados¶

Verificar atualizações $ lê o manifesto do WRI e informa quantos conjuntos de dados têm uma versão mais recente. Isso é uma solicitação no bucket do WRI. Portanto, gera uma pequena cobrança na sua conta da AWS.
Atualizar tudo para o mais recente baixa a versão mais recente de cada conjunto de dados que lê uma cópia local. Antes de o download começar, você deve marcar a caixa Entendo que minha conta da AWS é cobrada por estes downloads.
Salvar esta configuração guarda as opções atuais dos conjuntos de dados. Voltar para esta configuração restaura uma configuração salva.

Avançado¶

O painel Avançado na parte de baixo da seção é para opções que a caixa de diálogo não consegue fazer. Para cada conjunto de dados, ele mostra Tipo de fonte, Local, Solicitante paga, Usar caminho do manifesto $, Testar conexão e Salvar fonte.

CUIDADO: Use o painel Avançado somente se você souber o local S3 do conjunto de dados. Um local errado dá resultados errados ou nenhum resultado.

Solicitante paga deve estar ativado para o bucket do WRI. Se estiver desativado, o aplicativo não faz uma solicitação cobrada.

Testar conexão no painel Avançado abre o armazenamento do conjunto de dados. Isso gera uma cobrança na sua conta da AWS. Um resultado com sucesso começa com "Conexão bem-sucedida." Um resultado com falha começa com "Falha na conexão:". As razões são estas:

Resultado	O que ele informa
"Conexão bem-sucedida. ..."	O conjunto de dados abriu e o aplicativo consegue lê-lo.
Solicitante paga desativado	A credencial está correta, mas Solicitante paga está desativado. Ative Solicitante paga.
A AWS rejeitou a credencial	A chave foi revogada, está errada ou não tem permissão.
Nenhuma credencial da AWS	Nenhuma chave da AWS está disponível. Adicione uma chave, depois salve e teste novamente.
A credencial salva não pode ser lida	O aplicativo não consegue descriptografar a chave salva. Digite a chave novamente e salve.
Inacessível	Um problema de rede ou de endpoint. Não é um problema de credencial.
Não é um armazenamento Zarr	O local está correto, mas não tem um armazenamento Zarr legível.
Tempo esgotado	O conjunto de dados não respondeu dentro do tempo limite.
Local não encontrado	Não há nada nesse local. Pressione Usar caminho do manifesto $.
Região diferente	O bucket está em uma região diferente. Altere `datasets.upstream.region` em `config.yaml`.
AccessDenied	A chave é válida, mas não consegue ler este bucket. Pressione Verificar credenciais.
Outro erro da AWS	A AWS enviou um código de erro diferente. A linha mostra o código.

Versões dos conjuntos de dados e dados locais¶

Esta seção mostra cada versão datada de cada conjunto de dados, onde o aplicativo a guarda e quanto espaço em disco ela usa.

O aplicativo guarda 3 tipos de cópia:

Salva automaticamente: o aplicativo cria estas cópias quando você executa listas. Elas contam para o Limite de espaço.
Download completo: uma cópia que você baixou em Fontes de conjuntos de dados. O aplicativo nunca a exclui.
Sua própria cópia: uma cópia em uma pasta que você selecionou. O aplicativo nunca a exclui.

Para alterar o limite de espaço, digite um valor de 1 a 10000 em Limite do cache automático (GB) e depois pressione Salvar limite. O padrão é 50 GB.

AVISO: Se o novo limite for menor que o espaço em uso, o aplicativo exclui imediatamente as camadas salvas mais antigas. Se uma execução posterior precisar de uma camada excluída, o aplicativo a baixa novamente, e isso gera uma cobrança na sua conta da AWS.

Para excluir cópias, selecione-as em Versões por conjunto de dados e depois pressione Excluir selecionadas. Leia a lista na caixa de diálogo e depois pressione Excluir.

Visualizações de mapa mostra o espaço em disco que os dados de mapa guardados usam. Digite um valor em Limite (GB) e depois pressione Salvar limite. O aplicativo guarda os mapas até que você os limpe. Para limpar os dados de mapa, use Limpar para as listas selecionadas… ou Limpeza total de todos os dados de mapa….

Memória¶

A seção Memória define quanta memória o aplicativo pode usar. Ela tem 4 partes:

1. Ambiente: Limite de memória do host / VM (GB). O aplicativo encontra este valor quando opera em um contêiner. Para definir um valor menor, pressione Substituir. Para voltar, pressione Usar o detectado.
2. Este aplicativo: Reservado para o sistema operacional (GB) e Memória alocada ao aplicativo (GB). A reserva padrão é o maior valor entre 3 GB e 10% do limite do host. O aplicativo também mostra um mínimo recomendado. Até que o aplicativo meça um valor, o mínimo é 2.0 GB.
3. Como a alocação é dividida: uma tabela das frações. Você não pode alterar as frações nesta página. Elas são definidas em config.yaml (analysis.memory_shares) e se aplicam depois de uma reinicialização.
4. Detalhe de renderização: Máximo de células em resolução nativa. Este é o número máximo de células que uma vista em resolução nativa pode retornar.

Para alterar os valores de memória:

Digite os novos valores.
Verifique se a seção não mostra erro.
Pressione Aplicar.

Os valores se aplicam imediatamente. Você não precisa reiniciar o aplicativo.

CUIDADO: Se Memória alocada ao aplicativo (GB) for menor que o mínimo recomendado, uma análise pode falhar. O aplicativo mostra um aviso, mas permite aplicar o valor.

Idioma¶

O seletor de idioma está na barra superior, à direita de ⚙ Configurações. Ele tem estes idiomas: English (en), Español (es), Français (fr), Bahasa Indonesia (id) e Português (pt).

Pressione o seletor de idioma.
Selecione um idioma.

O aplicativo muda o idioma imediatamente. O navegador guarda a sua seleção para a próxima visita.

NOTA: Este guia do usuário também está disponível nos outros idiomas do aplicativo: English, Español, Français e Bahasa Indonesia. Use o guia no idioma que você selecionar, para que os rótulos do guia sejam iguais aos rótulos da sua tela.

O arquivo de configuração¶

O arquivo de configuração contém as configurações que a página Configurações não pode alterar. Na imagem Docker, o arquivo é /data/config.yaml. A variável de ambiente LUC_ANALYTICS_CONFIG pode informar um caminho diferente.

Quando o contêiner inicia pela primeira vez, ele cria /data/config.yaml a partir de config.example.yaml. Ele ativa os envios e define a raiz de download como /data/datasets. O arquivo também ativa o provedor Copernicus. Consulte O mapa base Sentinel-2. O contêiner nunca altera um arquivo de configuração que existe.

config.example.yaml lista cada chave com o seu valor padrão. Na imagem Docker, /data/config.yaml é uma cópia completa desse arquivo, e o aplicativo lê somente /data/config.yaml. Se você remover uma chave dele, o aplicativo usa o valor padrão do código do programa. Este valor pode ser diferente do valor em config.example.yaml. Por exemplo, o padrão do programa para maps.cdse_enabled é false.

NOTA: Se você iniciar o aplicativo sem Docker, com um arquivo que tem o nome config.yaml, o aplicativo lê primeiro config.example.yaml. Os valores em config.yaml então substituem os valores em config.example.yaml. Recomendamos que este config.yaml contenha somente as chaves que você altera.

Estas chaves têm relação com a página Configurações:

Chave	O que ela controla
`datasets.download_roots`	As pastas para onde os downloads podem ir. Uma lista vazia bloqueia todos os downloads.
`datasets.browse_roots`	Mais pastas que o navegador de pastas mostra. O aplicativo somente lê estas pastas.
`datasets.upstream.region`, `datasets.upstream.regions`	A região AWS das fontes S3. O bucket do WRI está em `us-east-1`.
`datasets.upstream.cadence`	A frequência com que cada conjunto de dados muda. Isso define a opção Recomendado.
`datasets.cost_model`	Os preços que o aplicativo usa para calcular o custo das leituras S3.
`datasets.zarr_store.max_gb`	O limite do cache automático (live; padrão 50).
`viz.grid_store_max_gb`	O limite das visualizações de mapa (live; padrão 2.0).
`analysis.memory_budget_gb`	A memória alocada ao aplicativo (live; padrão 1.5).
`analysis.memory_shares`	As partes da alocação de memória.
`analysis.zoom_adaptive.max_cells_ceiling`	Máximo de células em resolução nativa (live; padrão 200000).
`security.*`	A chave mestra, a pasta do armazenamento de segredos, a pasta de segredos do Docker e os nomes do Gerenciador de Credenciais.
`maps.*`	Os provedores de mapa base, por exemplo `maps.cdse_enabled`.
`ingest.upload_enabled`	Envios ativados ou desativados.

Uma chave com a palavra "live" na tabela também pode mudar na página Configurações. A página salva o valor no arquivo de sobreposição de tempo de execução (runtime.overlay_path, padrão ./data/runtime-overlay.yaml). Na imagem Docker, este arquivo é /data/data/runtime-overlay.yaml. Um valor na sobreposição de tempo de execução tem prioridade sobre a mesma chave em config.yaml. Todas as outras chaves se aplicam somente depois de uma reinicialização.

Alterar o arquivo de configuração no Docker¶

O arquivo /data/config.yaml está no volume Docker, não no seu computador. Para alterá-lo, copie-o para fora do contêiner, altere a cópia e copie-a de volta para dentro. Estas etapas usam o nome de contêiner luc-analytics de Instalar e iniciar o aplicativo.

AVISO: Não escreva credenciais em config.yaml. O aplicativo não lê credenciais do arquivo de configuração. Use a seção Credenciais, variáveis de ambiente, segredos do Docker ou o Gerenciador de Credenciais do Windows.

CUIDADO: Não altere à mão o arquivo de sobreposição de tempo de execução. Se ele contiver uma chave que não é permitida, o aplicativo ignora o arquivo completo.

Abra um terminal em uma pasta do seu computador.
Copie o arquivo para fora do contêiner:

docker cp luc-analytics:/data/config.yaml config.yaml

Faça uma segunda cópia de config.yaml com o nome config.yaml.bak. Guarde-a para restaurar se a alteração falhar.
Abra config.yaml em um editor de texto.
Encontre a chave em config.example.yaml e copie o nome dela exatamente. Para ler config.example.yaml, digite docker exec luc-analytics cat /app/config.example.yaml.
Altere o valor. Mantenha o recuo da estrutura YAML.
Salve o arquivo.
Copie o arquivo de volta para dentro do contêiner:

docker cp config.yaml luc-analytics:/data/config.yaml

Reinicie o contêiner:

docker restart luc-analytics

Digite docker logs luc-analytics e leia o log. Se um nome de chave estiver errado, o log mostra um aviso com o nome completo da chave.

NOTA: docker cp torna o usuário root o proprietário do arquivo copiado. O aplicativo opera como o usuário 10001 e somente lê /data/config.yaml. Portanto, você não precisa alterar o proprietário do arquivo.

CUIDADO: Uma chave desconhecida em security para o carregamento da configuração. Se o aplicativo não iniciar depois de uma alteração, copie config.yaml.bak de volta para dentro do contêiner com docker cp e depois reinicie o contêiner.