As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Como usar opções de configuração do Apache Airflow no Amazon MWAA
As opções de configuração do Apache Airflow podem ser anexadas ao seu ambiente Amazon Managed Workflows for Apache Airflow como variáveis de ambiente. É possível escolher na lista suspensa sugerida ou especificar opções de configuração personalizadas para sua versão do Apache Airflow no console Amazon MWAA. Este tópico descreve as opções de configuração do Apache Airflow disponíveis e como usar essas opções para substituir as configurações do Apache Airflow em seu ambiente.
**Contents**
+ [Pré-requisitos](#configuring-env-variables-prereqs)
+ [Como funciona](#configuring-env-variables-how)
+ [Como usar opções de configuração para fazer upload de plug-ins](#configuring-2.0-airflow-override)
+ [Visão geral das opções de configuração](#configuring-env-variables-customizing)
+ [Opções de configuração do Apache Airflow](#configuring-env-variables-airflow-ref)
+ [Referência do Apache Airflow](#configuring-env-variables-reference-options)
+ [Como usar o console do Amazon SNS](#configuring-env-variables-console-add)
+ [Referência da configuração](#configuring-env-variables-reference)
+ [Configurações de e-mail](#configuring-env-variables-email)
+ [Configurações da tarefa](#configuring-env-variables-tasks)
+ [Configurações de scheduler](#configuring-env-variables-scheduler)
+ [Configurações do operador](#configuring-env-variables-workers)
+ [Configuração do servidor Web](#configuring-env-variables-webserver)
+ [Configurações do acionador](#configuring-env-variables-webserver)
+ [Exemplos e código de exemplo](#configuring-env-variables-code)
+ [Exemplo de DAG](#configuring-env-variables-dag)
+ [Exemplo de configurações de notificação por e-mail](#configuring-env-variables-email)
+ [Próximas etapas](#configuring-env-variables-next-up)
## Pré-requisitos
Você precisará do seguinte antes de concluir as etapas nesta página.
+ **Permissões**: sua Conta da AWS deve ter o acesso concedido por seu administrador para a política de controle de acesso [AmazonMWAAFullConsoleAccess](access-policies.md#console-full-access) para seu ambiente. Além disso, seu ambiente Amazon MWAA deve ser autorizado pela seu [perfil de execução](mwaa-create-role.md) para acessar os recursos da AWS usados pelo seu ambiente.
+ **Acesso**: se você precisar de acesso a repositórios públicos para instalar dependências diretamente no servidor web, seu ambiente deverá ser configurado com acesso ao servidor Web de **rede pública**. Para obter mais informações, consulte [Modos de acesso do Apache Airflow](configuring-networking.md).
+ **Configuração do Amazon S3**: o [bucket do Amazon S3](mwaa-s3-bucket.md) usado para armazenar seus DAGs, plug-ins personalizados em `plugins.zip` e dependências do Python em `requirements.txt` deve ser configurado com *Acesso público bloqueado* e *Versionamento habilitado*.
## Como funciona
Quando você cria um ambiente, o Amazon MWAA anexa as definições de configuração que você especifica no console do Amazon MWAA nas **opções de configuração do Airflow** como variáveis de ambiente ao contêiner AWS Fargate do seu ambiente. Se você estiver usando uma configuração com o mesmo nome em `airflow.cfg`, as opções especificadas no console do Amazon MWAA substituirão os valores em `airflow.cfg`.
Embora não o exponhamos `airflow.cfg` na interface de usuário do Apache Airflow de um ambiente do Amazon MWAA por padrão, é possível alterar as opções de configuração do Apache Airflow diretamente no console do Amazon MWAA, incluindo a configuração `webserver.expose_config` para expor as definições.
## Como usar opções de configuração para fazer upload de plug-ins
Por padrão, no Apache Airflow v2 e nas versões posteriores os plug-ins são configurados para terem o upload sendo feito “lentamente” usando a configuração `core.lazy_load_plugins : True`. Se estiver usando plug-ins personalizados, você deverá adicionar `core.lazy_load_plugins : False` como uma opção de configuração do Apache Airflow para fazer upload de plug-ins no início de cada processo do Airflow para substituir a configuração padrão.
## Visão geral das opções de configuração
Ao adicionar uma configuração no console do Amazon MWAA, o Amazon MWAA grava a configuração como uma variável de ambiente.
+ **Opções listadas**. É possível escolher uma das configurações disponíveis para sua versão do Apache Airflow na lista suspensa. Por exemplo, `dag_concurrency` : `16`. A configuração é traduzida para o contêiner Fargate do seu ambiente como `AIRFLOW__CORE__DAG_CONCURRENCY : 16`
+ **Opções personalizadas**. Também é possível especificar as opções de configuração do Airflow que não estão listadas para sua versão do Apache Airflow na lista suspensa. Por exemplo, `foo.user` : `YOUR_USER_NAME`. A configuração é traduzida para o contêiner Fargate do seu ambiente como `AIRFLOW__FOO__USER : YOUR_USER_NAME`
### Opções de configuração do Apache Airflow
A imagem a seguir mostra onde é possível personalizar as **opções de configuração do Apache Airflow** no console do Amazon MWAA.
### Referência do Apache Airflow
Para obter uma lista das opções de configuração que tem suporte pelo Apache Airflow, consulte [Referência de configuração](https://airflow.apache.org/docs/apache-airflow/stable/configurations-ref.html) no *Guia de referência do Apache Airflow*. Para acessar as opções da versão do Apache Airflow que você está executando no Amazon MWAA, selecione a versão na lista suspensa.
### Como usar o console do Amazon SNS
O procedimento a seguir descreve as etapas para adicionar uma opção de configuração do Airflow ao seu ambiente.
1. Abra a [página Ambientes](https://console.aws.amazon.com/mwaa/home#/environments) no console do Amazon MWAA.
1. Escolha um ambiente.
1. Escolha **Editar**.
1. Escolha **Próximo**.
1. Escolha **Adicionar configuração personalizada** no painel **Opções de configuração do Airflow**.
1. Escolha uma configuração na lista suspensa e insira um valor, ou digite uma configuração personalizada e insira um valor.
1. Escolha **Adicionar configuração personalizada** para cada configuração que você deseja adicionar.
1. Escolha **Salvar**.
## Referência da configuração
A seção a seguir contém a lista de configurações disponíveis do Apache Airflow na lista suspensa no console do Amazon MWAA.
### Configurações de e-mail
A lista a seguir mostra as opções de configuração de notificação por e-mail do Airflow disponíveis no Amazon MWAA para Apache Airflow v2 e v3.
Recomendamos usar a porta 587 para tráfego SMTP. Por padrão, AWS bloqueia o tráfego SMTP de saída na porta 25 de todas as instâncias do Amazon EC2. Se precisar enviar tráfego de saída na porta 25, é possível [solicitar que essa restrição seja removida](https://aws.amazon.com/premiumsupport/knowledge-center/ec2-port-25-throttle/).
| Opção de configuração do Airflow | Descrição | Valor de exemplo |
| --- | --- | --- |
| email.email\_backend | O utilitário do Apache Airflow usado para notificações por e-mail em [email\_backend](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#email-backend). | airflow.utils.email.send\_email\_smtp |
| smtp.smtp\_host | O nome do servidor de saída usado para o endereço de e-mail em [smtp\_host](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-host). | localhost |
| smtp.smtp\_starttls | O Transport Layer Security (TLS) é usado para criptografar o e-mail pela Internet em [smtp\_starttls](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-starttls). | Falso |
| smtp.smtp\_ssl | O Secure Sockets Layer (SSL) é usado para conectar o servidor e o e-mail de cliente em [smtp\_ssl.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-ssl) | Verdadeiro |
| smtp.smtp\_port | A porta Transmission Control Protocol (TCP) designada para o servidor em [smtp\_port](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-port). | 587 |
| smtp.smtp\_mail\_from | O endereço de e-mail de saída em [smtp\_mail\_from](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-mail-from). | myemail@domain.com |
### Configurações da tarefa
A lista a seguir mostra as configurações disponíveis na lista suspensa para tarefas do Airflow no Amazon MWAA para Apache Airflow v2 e v3.
| Opção de configuração do Airflow | Descrição | Valor de exemplo |
| --- | --- | --- |
| core.default\_task\_retries | O número de vezes para repetir uma tarefa do Apache Airflow em [default\_task\_retries](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#default-task-retries). | 3 |
| core.parallelism | O número máximo de instâncias de tarefas que podem ser executadas simultaneamente em todo o ambiente em paralelo ([paralelismo](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#parallelism)). | 40 |
### Configurações de scheduler
A lista a seguir mostra as configurações do agendador do Apache Airflow disponíveis na lista suspensa do Amazon MWAA para Apache Airflow v2 e v3.
| Opção de configuração do Airflow | Descrição | Valor de exemplo |
| --- | --- | --- |
| scheduler.catchup\_by\_default | Solicita ao scheduler que crie uma execução do DAG para “acompanhar” o intervalo de tempo específico em [catchup\_by\_default](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#catchup-by-default). | Falso |
| scheduler.scheduler\_zombie\_task\_threshold Não está disponível no Apache Airflow v3. | Informa ao agendador se a instância da tarefa deve ser marcada como falha e reprogramar a tarefa em [scheduler\_zombie\_task\_threshold.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#scheduler-zombie-task-threshold) | 300 |
### Configurações do operador
A lista a seguir mostra as configurações de operador do Airflow disponíveis na lista suspensa do Amazon MWAA para Apache Airflow v2 e v3.
| Opção de configuração do Airflow | Descrição | Valor de exemplo |
| --- | --- | --- |
| celery.worker\_autoscale | O número máximo e mínimo de tarefas que podem ser executadas simultaneamente em qualquer operador usando o [Executor Celery](https://airflow.apache.org/docs/apache-airflow/2.0.2/executor/celery.html) em [worker\_autoscale.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#worker-autoscale) O valor deve ser separado por vírgula na seguinte ordem: `max_concurrency,min_concurrency`. | 16,12 |
### Configuração do servidor Web
A lista a seguir mostra as configurações do servidor Web do Apache Airflow disponíveis na lista suspensa do Amazon MWAA para Apache Airflow v2 e v3.
| Opção de configuração do Airflow | Descrição | Valor de exemplo |
| --- | --- | --- |
| webserver.default\_ui\_timezone Não está disponível no Apache Airflow v3. | A configuração padrão de data e hora do IU do Apache Airflow em [default\_ui\_timezone.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#default-ui-timezone) Definir a opção `default_ui_timezone` não altera o fuso horário no qual seus DAGs estão programados para serem executados. Para alterar o fuso horário dos DAGs, é possível usar um plug-in personalizado. Para obter mais informações, consulte [Como alterar o fuso horário de um DAG no Amazon MWAA](samples-plugins-timezone.md). | America/New\_York |
### Configurações do acionador
A lista a seguir mostra as configurações do [acionador](https://airflow.apache.org/docs/apache-airflow/stable/authoring-and-scheduling/deferring.html) do Apache Airflow disponíveis no Amazon MWAA para Apache Airflow v2 e v3.
| Opção de configuração do Airflow | Descrição | Valor de exemplo |
| --- | --- | --- |
| mwaa.triggerer\_enabled | Usado para ativar e desativar o acionador no Amazon MWAA. Por padrão, esse valor é definido como `True`. Se definido como `False`, o Amazon MWAA não iniciará nenhum processo acionador nos agendadores. | Verdadeiro |
| triggerer.default\_capacity (na v2)
triggerer.capacity (na v3) | Define o número de acionadores que cada acionador pode executar em paralelo. No Amazon MWAA, essa capacidade é definida por cada acionador e por cada agendador, pois os dois componentes são executados lado a lado. O padrão por programador é definido como `60`, `125`, `250`, `500` e `1000` para instâncias pequenas, médias, grandes, extragrandes e extra extragrandes, respectivamente. | 125 |
## Exemplos e código de exemplo
### Exemplo de DAG
É possível usar o seguinte DAG para imprimir suas opções de configuração do Apache Airflow `email_backend`. Para executar em resposta aos eventos do Amazon MWAA, copie o código para a pasta DAGs do seu ambiente no seu bucket de armazenamento do Amazon S3.
```
from airflow.decorators import dag
from datetime import datetime
def print_var(**kwargs):
email_backend = kwargs['conf'].get(section='email', key='email_backend')
print("email_backend")
return email_backend
@dag(
dag_id="print_env_variable_example",
schedule_interval=None,
start_date=datetime({{yyyy}}, {{m}}, {{d}}),
catchup=False,
)
def print_variable_dag():
email_backend_test = PythonOperator(
task_id="email_backend_test",
python_callable=print_var,
provide_context=True
)
print_variable_test = print_variable_dag()
```
### Exemplo de configurações de notificação por e-mail
As seguintes opções de configuração do Apache Airflow podem ser usadas para uma conta de e-mail do Gmail.com usando uma senha de aplicativo. Para obter mais informações, consulte [Fazer login usando senhas de aplicativos](https://support.google.com/mail/answer/185833?hl=en-GB) no *guia de referência da Ajuda do Gmail*.
## Próximas etapas
+ Aprenda a fazer upload de sua pasta do DAG para seu bucket do Amazon S3 em [Como adicionar ou atualizar DAGs](configuring-dag-folder.md).