Instalação por Pacotes do Angie PRO

Para acessar o repositório de pacotes, você precisa assinar um contrato e adquirir uma licença. Para questões sobre licenças, contratos e builds personalizados, entre em contato:

• https://angie.software/

• +7 (495) 120 50 33

Em seguida, configure o repositório para o gerenciador de pacotes da sua distribuição para instalar e atualizar o Angie PRO e os módulos dinâmicos que você precisa. Por fim, instale o arquivo de licença e remova as restrições.

Distribuições

Nome	Versões	Arquiteturas
AlmaLinux	10,   9,   8	x86-64, arm64
Alpine	3.22,   3.21,   3.20,   3.19	x86-64, arm64
Alt	11,   10 8	x86-64, arm64 x86-64
Astra SE	4.7 1.8, 1.7	arm64 x86-64
CentOS	10,   9	x86-64, arm64
Debian	13,   12,   11	x86-64, arm64
FreeBSD	14,   13	x86-64, arm64
MSVSphere	9	x86-64
openSUSE	15	x86-64, arm64
Oracle Linux	10,   9,   8	x86-64, arm64
OSNova	3.3.0,   2.13	x86-64
RED OS	8,   7	x86-64, arm64
Rocky Linux	10,   9,   8	x86-64, arm64
ROSA	Chrome 13 Chrome 12 Fresh 12	x86-64 x86-64, arm64 x86-64
SberLinux	9	x86-64
Ubuntu	24.04,   22.04,   20.04	x86-64, arm64

Alma, CentOS, MSVSphere, Oracle, RED OS, Rocky, ROSA, SberLinux

1. Crie o diretório /etc/ssl/angie/:

   $ sudo mkdir -p /etc/ssl/angie/
   

2. Transfira os arquivos que você recebeu com sua licença:

   Tipo de Arquivo	Nome Original	Onde
   Certificado	angie-repo.crt	/etc/ssl/angie/angie-repo.crt
   Chave Privada	angie-repo.key	/etc/ssl/angie/angie-repo.key

   Dica

   Se você tem a licença mas não estes arquivos, envie-nos um email para .

3. Para adicionar o repositório, crie o arquivo /etc/yum.repos.d/angie.repo com o seguinte conteúdo:

   AlmaCentOSMSVSphereOracleRED OSRockyROSA ChromeROSA FreshSberLinux

   [angie-pro]
   name=Angie PRO repo
   baseurl=https://download.angie.software/angie-pro/almalinux/$releasever/
   sslclientcert=/etc/ssl/angie/angie-repo.crt
   sslclientkey=/etc/ssl/angie/angie-repo.key
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   

4. Instale o pacote Angie PRO:

   $ sudo yum install -y angie-pro
   $ # -- OU --
   $ sudo dnf install -y angie-pro
   

5. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo yum install -y <NOME DO PACOTE>
   $ # -- OU --
   $ sudo dnf install -y <NOME DO PACOTE>
   

6. Inicie o serviço:

   $ sudo systemctl start angie
   

7. Para iniciar automaticamente o Angie PRO após a reinicialização do servidor:

   $ sudo systemctl enable angie
   

Alpine

1. Transfira os arquivos que você recebeu com sua licença:

   Tipo de Arquivo	Nome Original	Onde
   Certificado	angie-repo.crt	/etc/apk/cert.pem
   Chave Privada	angie-repo.key	/etc/apk/cert.key

   Dica

   Se você tem a licença mas não estes arquivos, envie-nos um email para .

2. Instale os pacotes auxiliares para adicionar o repositório Angie PRO:

   $ sudo apk update
   $ sudo apk add curl ca-certificates
   

3. Baixe a chave pública do repositório Angie PRO para verificação de pacotes:

   $ sudo curl -o /etc/apk/keys/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   

4. Adicione o repositório Angie PRO:

   $ echo "https://download.angie.software/angie-pro/alpine/v$(egrep -o \
          '[0-9]+\.[0-9]+' /etc/alpine-release)/main" \
          | sudo tee -a /etc/apk/repositories > /dev/null
   

5. Atualize os índices do repositório:

   $ sudo apk update
   

6. Instale o pacote Angie PRO:

   $ sudo apk add angie-pro
   

7. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo apk add <NOME DO PACOTE>
   

8. Inicie o serviço:

   $ sudo service angie start
   

9. Para iniciar automaticamente o Angie PRO após a reinicialização do servidor:

   $ sudo rc-update add angie
   

Alt

1. Crie o diretório /etc/ssl/angie/:

   $ sudo mkdir -p /etc/ssl/angie/
   

2. Transfira os arquivos que você recebeu com sua licença:

   Tipo de Arquivo	Nome Original	Onde
   Certificado	angie-repo.crt	/etc/ssl/angie/angie-repo.crt
   Chave Privada	angie-repo.key	/etc/ssl/angie/angie-repo.key

   Dica

   Se você não possui esses arquivos mas tem uma licença, entre em contato com o suporte: .

3. Baixe a chave pública do repositório Angie PRO para verificação de pacotes:

   $ curl -o ~/angie-signing.gpg https://angie.software/keys/angie-signing.gpg && \
          sudo gpg --no-default-keyring --keyring /usr/lib/alt-gpgkeys/pubring.gpg --import ~/angie-signing.gpg
   

4. Salve a assinatura da chave:

   $ echo 'simple-key "angie-pro" {
             Fingerprint "EB8EAF3D4EF1B1ECF34865A2617AB978CB849A76";
             Name "Angie PRO (Signing Key) <devops@tech.wbsrv.ru>";
     }' | sudo tee /etc/apt/vendors.list.d/angie.list > /dev/null
   

5. Adicione o repositório Angie PRO:

   Alt 11Alt 10Alt SP 10Alt SP 8

   $ echo "rpm [angie-pro] https://download.angie.software/angie-pro/altlinux/11/ $(uname -m) main" \
       | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   

6. Crie o arquivo de configuração apt do repositório Angie PRO em /etc/apt/apt.conf.d:

   $ ( echo 'Acquire::https::Verify-Peer "true";';
       echo 'Acquire::https::Verify-Host "true";';
       echo 'Acquire::https::SslCert     "/etc/ssl/angie/angie-repo.crt";';
       echo 'Acquire::https::SslKey      "/etc/ssl/angie/angie-repo.key";';
     )  | sudo tee -a /etc/apt/apt.conf >/dev/null
   

7. Atualize os índices do repositório:

   $ sudo apt-get update
   

8. Instale o pacote Angie PRO:

   $ sudo apt-get install -y angie-pro
   

9. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo apt-get install -y <NOME DO PACOTE>
   

10. Inicie o serviço:

    $ sudo systemctl start angie
    

11. Para iniciar automaticamente o Angie PRO após a reinicialização do servidor:

    $ sudo systemctl enable angie
    

Astra SE

1. Crie o diretório /etc/ssl/angie/:

   $ sudo mkdir -p /etc/ssl/angie/
   

2. Transfira os arquivos que você recebeu com sua licença:

   Tipo de Arquivo	Nome Original	Onde
   Certificado	angie-repo.crt	/etc/ssl/angie/angie-repo.crt
   Chave Privada	angie-repo.key	/etc/ssl/angie/angie-repo.key

   Dica

   Se você não possui esses arquivos mas tem uma licença, entre em contato com o suporte: .

   Restrinja o acesso ao diretório e arquivos:

   $ sudo chown -R _apt:nogroup /etc/ssl/angie/
   

3. Instale os pacotes auxiliares para adicionar o repositório Angie PRO:

   $ sudo apt-get update
   $ sudo apt-get install -y apt-transport-https lsb-release \
                  ca-certificates curl gnupg2
   

4. Baixe a chave pública do repositório Angie PRO para verificação de pacotes:

   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   

5. Adicione o repositório Angie PRO:

   $ echo "deb https://download.angie.software/angie-pro/astra-se/$(egrep -o \
          '[0-9]+\.[0-9]+' /etc/astra_version) unstable main" \
          | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   

6. Para configurar o repositório, crie um arquivo /etc/apt/apt.conf.d/90download-angie com o seguinte conteúdo:

   Acquire::https::download.angie.software::Verify-Peer "true";
   Acquire::https::download.angie.software::Verify-Host "true";
   Acquire::https::download.angie.software::SslCert     "/etc/ssl/angie/angie-repo.crt";
   Acquire::https::download.angie.software::SslKey      "/etc/ssl/angie/angie-repo.key";
   

7. Atualize os índices do repositório:

   $ sudo apt-get update
   

8. (Opcional) Ao executar no modo Ambiente de Software Fechado (CSE), instale o pacote de chave para verificar a autenticidade dos arquivos executáveis do Angie PRO:

   $ sudo apt-get install -y angie-digsig-key
   

   Atualize o CSE:

   $ sudo update-initramfs -uk all
   

   Em seguida reinicie o servidor:

   $ sudo shutdown -r now
   

9. Instale o pacote Angie PRO:

   $ sudo apt-get install -y angie-pro
   

10. (Opcional) Instale quaisquer pacotes extras que você precisar:

    $ sudo apt-get install -y <NOME DO PACOTE>
    

Debian, Ubuntu

1. Crie o diretório /etc/ssl/angie/:

   $ sudo mkdir -p /etc/ssl/angie/
   

2. Transfira os arquivos que você recebeu com sua licença:

   Tipo de Arquivo	Nome Original	Onde
   Certificado	angie-repo.crt	/etc/ssl/angie/angie-repo.crt
   Chave Privada	angie-repo.key	/etc/ssl/angie/angie-repo.key

   Dica

   Se você não tem esses arquivos mas possui uma licença, entre em contato com o suporte: .

   Restrinja o acesso ao diretório e arquivos:

   $ sudo chown -R _apt:nogroup /etc/ssl/angie/
   

3. Instale os pré-requisitos para adicionar o repositório Angie PRO:

   $ sudo apt-get update
   $ sudo apt-get install -y apt-transport-https lsb-release \
                  ca-certificates curl gnupg2
   

4. Baixe a chave pública do repositório Angie PRO para verificação de pacotes:

   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   

5. Adicione o repositório Angie PRO:

   $ echo "deb https://download.angie.software/angie-pro/$(. /etc/os-release && echo "$ID/$VERSION_ID $VERSION_CODENAME") main" \
       | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   

6. Para configurar o repositório, crie um arquivo chamado /etc/apt/apt.conf.d/90download-angie com o seguinte conteúdo:

   Acquire::https::download.angie.software::Verify-Peer "true";
   Acquire::https::download.angie.software::Verify-Host "true";
   Acquire::https::download.angie.software::SslCert     "/etc/ssl/angie/angie-repo.crt";
   Acquire::https::download.angie.software::SslKey      "/etc/ssl/angie/angie-repo.key";
   

7. Atualize os índices do repositório:

   $ sudo apt-get update
   

8. Instale o pacote Angie PRO:

   $ sudo apt-get install -y angie-pro
   

9. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo apt-get install -y <NOME DO PACOTE>
   

OSNova

1. Instale os pré-requisitos para adicionar o repositório Angie PRO:

   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl
   

2. Baixe a chave pública do repositório Angie PRO para verificação de pacotes:

   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   

3. Adicione o repositório Angie PRO:

   $ echo "deb https://download.angie.software/angie-pro/osnova/$(egrep -o \
          '[0-9]*' /etc/osnova_version | head -1) \
          $(. /etc/os-release && echo "$VERSION_CODENAME") main" \
          | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   

4. Atualize os índices do repositório:

   $ sudo apt-get update
   

5. Instale o pacote Angie PRO:

   $ sudo apt-get install -y angie
   

6. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo apt-get install -y <NOME DO PACOTE>
   

FreeBSD

1. Para adicionar o repositório Angie PRO, crie estes diretórios:

   $ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
   

2. Para configurar o repositório, crie um arquivo chamado /usr/local/etc/pkg/repos/angie.conf com o seguinte conteúdo:

   angie: {
      url: "https://download.angie.software/angie-pro/freebsd/${VERSION_MAJOR}/${ARCH}",
      signature_type: "pubkey",
      pubkey: "/usr/local/etc/pkg/angie/angie-signing.rsa",
      enabled: yes
   }
   

3. Baixe a chave pública do repositório Angie PRO para verificação de pacotes:

   $ sudo curl -o /usr/local/etc/pkg/angie/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   

4. Transfira os arquivos que você recebeu com sua licença:

   Tipo de Arquivo	Nome Original	Onde
   Certificado	angie-repo.crt	/usr/local/etc/pkg/angie/angie-repo.crt
   Chave Privada	angie-repo.key	/usr/local/etc/pkg/angie/angie-repo.key

   Dica

   Se você não tem esses arquivos mas possui uma licença, entre em contato com o suporte: .

5. Adicione o certificado e a chave à configuração do gerenciador de pacotes:

   $ echo '
     PKG_ENV: {
       SSL_CLIENT_CERT_FILE: "/usr/local/etc/pkg/angie/angie-repo.crt",
       SSL_CLIENT_KEY_FILE:  "/usr/local/etc/pkg/angie/angie-repo.key"
     }' | sudo tee -a /usr/local/etc/pkg.conf > /dev/null
   

6. Atualize os índices do repositório:

   $ sudo pkg update
   

7. Instale o pacote Angie PRO:

   $ sudo pkg install -y angie-pro
   

8. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo pkg install -y <NOME DO PACOTE>
   

9. Inicie o serviço:

   $ sudo service angie start
   

10. Para iniciar automaticamente o Angie PRO após a reinicialização do servidor:

    $ sudo sysrc angie_enable=YES
    

openSUSE

1. Crie o diretório /etc/ssl/angie/:

   $ sudo mkdir -p /etc/ssl/angie/
   

2. Transfira os arquivos que você recebeu com sua licença:

   Tipo de Arquivo	Nome Original	Onde
   Certificado	angie-repo.crt	/etc/ssl/angie/angie-repo.crt
   Chave Privada	angie-repo.key	/etc/ssl/angie/angie-repo.key

   Em seguida, combine-os em um pacote /etc/ssl/angie/angie-repo-bundle.crt:

   $ cat /etc/ssl/angie/angie-repo.crt /etc/ssl/angie/angie-repo.key | \
         sudo tee -a /etc/ssl/angie/angie-repo-bundle.crt > /dev/null
   

   Dica

   Se você não tem esses arquivos mas possui uma licença, entre em contato com o suporte: .

3. Para adicionar o repositório, crie um arquivo chamado /etc/zypp/repos.d/angie.repo com o seguinte conteúdo:

   [angie-pro]
   enabled=1
   autorefresh=1
   baseurl=https://download.angie.software/angie-pro/opensuse/$releasever_major?ssl_clientcert=/etc/ssl/angie/angie-repo-bundle.crt&ssl_verify=peer
   gpgcheck=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   

4. Atualize os índices do repositório:

   $ sudo zypper refresh
   

5. Instale o pacote Angie PRO:

   $ sudo zypper install -y angie-pro
   

6. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo zypper install -y <NOME DO PACOTE>
   

7. Inicie o serviço:

   $ sudo systemctl start angie
   

8. Para iniciar automaticamente o Angie PRO após a reinicialização do servidor:

   $ sudo systemctl enable angie
   

Extras

Além dos pacotes que fornecem funcionalidade principal, também publicamos vários pacotes adicionais, tanto nossos próprios quanto de fontes terceirizadas selecionadas.

Painel Web Console Light

O Console Light é um painel web de monitoramento leve para o Angie PRO, publicado em nossos repositórios como o pacote angie-pro-console-light. Ele é instalado da mesma forma que o pacote angie nas instruções acima; para instruções de configuração, consulte a seção Painel Web de Monitoramento Console Light.

Módulos Dinâmicos

Para estender a funcionalidade básica do Angie PRO, você pode adicionar vários módulos dinâmicos. Você pode obtê-los como pacotes prontos do nosso repositório:

angie-pro-module-image-filter	Adiciona transformações de imagem para formatos JPEG, GIF, PNG e WebP.
angie-pro-module-njs: JS (HTTP), JS (stream)	Permite usar a linguagem njs (um subconjunto de JavaScript) na configuração do Angie PRO nos contextos http e stream respectivamente.
angie-pro-module-perl	Permite escrever manipuladores de location e variáveis em Perl, bem como chamar Perl a partir de SSI.
angie-pro-module-xslt	Adiciona um filtro que transforma respostas XML usando templates XSLT.

Para aplicar um módulo instalado em sua configuração, carregue-o usando a diretiva load_module no contexto main:

load_module modules/<module name>.so;

Uma ampla gama de módulos de terceiros também está disponível.

Arquivo de Licença

Para configurar a licença para o Angie PRO:

1. Salve o arquivo de licença como /etc/angie/license.pem, definindo as mesmas permissões que você usa para seus certificados de cliente.

2. Verifique se a licença é válida; caso contrário, verifique os detalhes:

   $ sudo angie -t
   
     angie: Valid license found:
     angie:   - owner: CN=Angie Client License
     angie:   - period: Jul  8 21:00:00 2024 GMT .. Jul 17 20:59:59 2024 GMT
     angie:
     angie: Limitations:
     angie:   - worker_processes_limit: 8
     angie:   - worker_connections_limit: 0
   

3. Monitore o console e os logs para quaisquer problemas de licenciamento. Se a licença expirar durante a operação, o Angie PRO emite periodicamente avisos correspondentes. Além disso, no recarregamento, mensagens de erro de configuração aparecerão se, por exemplo, o número de processos de trabalho especificado nos termos da licença for excedido.

4. Modifique o arquivo /etc/angie/angie.conf; após a instalação, dois parâmetros nele limitam a operação:

   worker_processes 1;
   worker_connections 256;
   

   Após salvar o arquivo de licença, altere-os de acordo com os termos da sua licença, por exemplo:

   worker_processes 8;
   worker_connections 65535;