Instale uma integração
Instale uma integração do Marketplace na sua conta e execute-a em uma aplicação ou em um firewall com uma function instance e uma regra do Rules Engine.
Você instala uma integração pelo Azion Marketplace e a executa em uma aplicação ou em um firewall pelo Azion Console. Esta página é o procedimento que todas as integrações compartilham. Cada integração também tem um guia próprio, com os argumentos que ela recebe. Para essa lista e para saber onde cada integração roda, consulte Integrações do Marketplace.
As integrações são instaladas de uma de duas formas. Algumas abrem um drawer de instalação que configura a integração em uma aplicação que você seleciona. Outras adicionam a function da integração à sua conta imediatamente. Depois, você ativa o módulo Functions de uma aplicação ou de um firewall, cria uma function instance ali e cria uma regra do Rules Engine que executa a instância.
Pré-requisitos
- Uma conta Azion. Para entrar, consulte Como acessar o Azion Console.
- Uma aplicação servida por um workload. Para criar uma, consulte Primeiros passos com Applications.
- Para uma integração que roda em um firewall, um firewall e a Azion CLI instalada e autorizada. A CLI vincula o firewall ao workload.
- Ativar um produto ou um módulo pode gerar custos de uso. Para mais informações, consulte Preços.
Instale a integração
Você instala uma integração uma vez por conta. Para instalá-la pelo Azion Console:
Acesse Azion Console > Marketplace.
Insira o nome da integração no campo Search on Marketplace e selecione o card dela. Navegar pelos cards e pelas Categories leva à mesma página.
O que acontece em seguida depende da integração.
Se o drawer Install an Integration abrir, a integração inclui um template de instalação. Para preencher o drawer:
Na seção Select an Application, selecione uma Application. Para criar uma, selecione Create New.
O drawer exibe um formulário com os argumentos próprios da integração. O guia da integração descreve cada um.
O drawer lista os privilégios que o Azion Marketplace exige na aplicação selecionada. Para saber o que cada um permite, consulte Permissões do Marketplace.
O Azion Console confirma que a integração foi instalada, e a integração roda na aplicação selecionada. As seções abaixo não se aplicam a ela.
Se nenhum drawer abrir, a instalação termina imediatamente. O card exibe Successfully installed! e Latest version installed!, e a function aparece na lista Function do drawer Create Instance. Continue com Execute-a em uma aplicação ou Execute-a em um firewall, conforme o guia da integração indica.
Execute-a em uma aplicação
Uma integração que roda em uma aplicação precisa de três alterações nessa aplicação. Faça-as na ordem abaixo.
Ative o módulo Functions
Uma aplicação executa uma function instalada somente enquanto o módulo Functions dela está ativado. Para ativar o módulo:
Acesse Azion Console > Applications > sua aplicação.
Na aba Main Settings, vá para a seção Modules.
A aplicação exibe uma aba Functions Instances, onde você instancia a function.
Crie a function instance
Uma function instance contém os argumentos que a integração lê em uma aplicação. Para criar a instância:
Em Applications, selecione sua aplicação e selecione a aba Functions Instances.
Uma aplicação ainda sem instância oferece a mesma ação como Function Instance. O drawer Create Instance abre.
Em Name, insira um nome único que identifique a instância.
Em Function, selecione a integração. O editor Arguments é preenchido com os argumentos padrão da integração em JSON.
Em Arguments, substitua os valores padrão pelos seus. O guia da integração descreve cada chave.
A instância aparece na aba Functions Instances com o nome que você inseriu.
Crie a regra
A instância só roda quando uma regra do Rules Engine a chama com o behavior Run Function. A regra abaixo corresponde a todas as requisições. Para criá-la:
Em Applications, selecione sua aplicação e selecione a aba Rules Engine.
Em Name, insira um nome. Por exemplo: Run my integration.
Na seção Phase, selecione Request Phase.
Na seção Criteria, mantenha a variável ${uri} e o operador starts with e insira / como argumento.
Na seção Behaviors, selecione Run Function e selecione a instância pelo nome que você deu a ela.
A regra aparece na aba Rules Engine, na fase de requisição, e executa a instância em todas as requisições. Algumas integrações precisam de mais behaviors na mesma regra, como Bypass Cache ou Forward Cookies. Esses behaviors e os critérios extras exigem o módulo Application Accelerator, e o guia da integração os lista.
Execute-a em um firewall
Uma integração que roda em um firewall precisa de três alterações no firewall e, depois, de um vínculo entre o firewall e seu workload.
Ative o módulo Functions
Um firewall exibe a aba Functions Instances somente enquanto o módulo Functions dele está ativado. Para ativar o módulo:
Acesse Azion Console > Firewalls > seu firewall.
Na aba Main Settings, vá para a seção Modules.
O firewall exibe a aba Functions Instances. Para todas as configurações deste formulário, consulte Defina as configurações principais de um firewall.
Crie a function instance
Uma function instance de firewall contém os argumentos que a integração lê nesse firewall. Para criar a instância:
Em Firewalls, selecione seu firewall e selecione a aba Functions Instances.
Um firewall ainda sem instância oferece a mesma ação como Function Instance. O drawer Create Instance abre.
Em Name, insira um nome único que identifique a instância.
Em Function, selecione a integração. A lista contém somente as functions que rodam em um firewall.
Em Arguments, substitua os valores padrão no editor JSON pelos seus. O guia da integração descreve cada chave.
A instância aparece na aba Functions Instances.
Crie a regra
Uma regra do Rules Engine for Firewall seleciona as requisições que chegam à instância, por meio do behavior Run Function. Para criar a regra:
Em Firewalls, selecione seu firewall e selecione a aba Rules Engine.
Em Name, insira um nome. Por exemplo: Run my integration.
Na seção Criteria, selecione as requisições que executam a integração. Por exemplo: if Hostname is equal xxxxxxxxxxxx.map.azionedge.net.
Na seção Behaviors, selecione Run Function e selecione a instância pelo nome que você deu a ela.
O firewall executa a instância em todas as requisições que correspondem ao critério.
Vincule o firewall ao workload
Um firewall inspeciona as requisições de um workload somente quando o deployment do workload o indica. Para criar um deployment que indique a aplicação e o firewall:
O comando exibe o ID do novo deployment:
As requisições ao domínio do workload chegam ao firewall, e a regra executa a instância nas requisições que correspondem ao critério dela.
Integrações de terceiros
Algumas integrações chamam uma ferramenta de outro fornecedor. Antes de instalar uma delas, você pode precisar de uma conta com esse fornecedor ou de uma configuração inicial do lado dele. Algumas dessas integrações também podem gerar custos de uso com o fornecedor.
A coluna Third-party account de Integrações do Marketplace informa quais integrações precisam de uma conta com o fornecedor. O guia próprio da integração descreve a configuração.
Encontre e atualize integrações instaladas
Cada integração instalada aparece na lista Function do drawer Create Instance. A lista Functions também pode exibir uma integração instalada, marcada por um ícone de carrinho na coluna Vendor.
A Azion e os parceiros dela publicam novas versões de integrações. Atualizar cria uma nova instância da function da integração. Para atualizar uma integração e mover suas instâncias para a nova versão, consulte Atualize uma integração.