skdlb
SKUDONET
Este é o repositório do SKUDONET Open Source Load Balancer e Open Source WAF Community Edition ( Zen Load Balancer CE próxima geração) e irá guiá-lo na instalação de uma instância de desenvolvimento e teste do balanceador de carga.
Neste repositório você encontrará o código fonte normalmente colocado na pasta /usr/local/skudonet/ com a seguinte estrutura:
app/ : Aplicativos, binários e bibliotecas que o SKUDONET Load Balancer requer.
bin/ : diretório adicional de binários do aplicativo.
backups/ : Pasta padrão onde serão colocados os backups de configuração.
config/ : Pasta padrão onde serão colocados os serviços de balanceamento de carga, verificações de integridade, IPDS WAF e arquivos de configuração de rede.
etc/ : Alguns arquivos de sistema para configurar os serviços do SKUDONET Load Balancer.
lib/ : Pasta onde está localizada a biblioteca de funcionalidades do Skudonet.
share/ : Pasta para modelos e outros dados.
www/ : arquivos de origem da API de back-end do SKUDONET Load Balancer.
other : Licença e informações deste leia-me. E /usr/share/perl5/Skudonet com todo o núcleo de backend do Skudonet.
Atualmente, só existe pacote disponível para Debian Bookworm, a instalação não é suportada neste sistema operacional.
Existem duas opções para implantar um balanceador de carga SKUDONET: a primeira é implantar o SKUDONET CE ISO e a outra é implantar uma imagem Debian Bookworm e instalar o Skudonet com suas dependências.
SKUDONET CE ISO é um modelo Debian Bookworm com Skudonet já instalado. Ele pode ser obtido no link a seguir, clicando no botão "Baixar imagem ISO".
https://www.skudonet.com/products/community/
Se você preferir instalar o skudonet você mesmo, você deve obter um ISO do Debian instalável em debian.org. Este processo de instalação foi testado apenas com a versão de 64 bits.
Por favor, leve em consideração estes requisitos antes de instalar o balanceador de carga:
Você precisará de pelo menos 1,5 GB de armazenamento.
Instale um sistema Debian Bookworm (64 bits) novo e básico com openssh e o pacote básico de ferramentas de sistema recomendado durante a instalação da distribuição.
Configure o balanceador de carga com um endereço IP estático. O SKUDONET Load Balancer ainda não oferece suporte a DHCP.
Configure os repositórios apt para poder instalar algumas dependências.
Este repositório git contém apenas o código fonte, os pacotes instaláveis baseados neste código são atualizados em nossos repositórios Skudonet APT, você pode usá-los configurando seu sistema Debian Bookworm da seguinte forma:
root@skudonetlb#> echo "deb http://repo.skudonet.com/ce/v7 bookworm main" >> /etc/apt/sources.list.d/skudonet.list root@skudonetlb#> wget -O - http://repo.skudonet.com/ce/skudonet.com.gpg.key | apt-key add -
Agora, atualize o banco de dados local do APT
root@skudonetlb#> apt-get update
E por fim, instale o Skudonet CE
root@skudonetlb#> apt-get install skudonet
Vá para um diretório para baixar o OWASP CoreRuleSet
root@skudonetlb#> cd /opt
Baixe o OWASP CoreRuleSet mais recente
root@skudonetlb#> wget https://github.com/coreruleset/coreruleset/archive/refs/heads/main.zip
Descompacte o arquivo OWASP CoreRuleSet
root@skudonetlb#> unzip main.zip
Copie todos os conjuntos de regras e dados para o diretório de configuração SKUDONET IPDS WAF Rulesets
root@skudonetlb#> cp coreruleset-main/rules/* /usr/local/skudonet/config/ipds/waf/sets/
Copie o arquivo de exemplo de configuração para o diretório de configuração SKUDONET IPDS WAF Rulesets É obrigatório configurar tx.crs_setup_version
root@skudonetlb#> grep -v "^SecDefaultAction" coreruleset-main/crs-setup.conf.example > /usr/local/skudonet/config/ipds/waf/sets/REQUEST-90-CONFIGURATION.conf
Agora o SKUDONET Opensource Load Balancer possui todos os conjuntos de regras OWASP e eles podem ser aplicados aos Farms HTTP/S.
Use o repositório Skudonet APT para verificar se há atualizações disponíveis.
Os erros Perl estão sendo registrados no arquivo /var/log/cherokee-error.log. Os logs de acesso da GUI da Web estão sendo registrados no arquivo /var/log/cherokee-access.log. Todos os logs de software (logs de farm, logs WAF, logs SKUDONET) vão para o arquivo /var/log/syslog. Os arquivos de configuração são salvos no diretório /usr/local/skudonet/config. Os conjuntos de regras SKUDONET WAF são salvos no diretório /usr/local/skudonet/config/ipds/waf/sets.
Você pode contribuir com a evolução do Load Balancer SKUDONET de diversas maneiras:
Criação de conteúdo : documentação no wiki do projeto GitHub, traduções de documentos, documentação do código-fonte, etc.
Ajuda a outros usuários através das listas de discussão.
Relatando e resolvendo bugs dos problemas do projeto GitHub.
Desenvolvimento de novas funcionalidades.
Use os problemas do projeto GitHub para relatar qualquer problema ou bug com o software. Tente descrever o problema e uma forma de reproduzi-lo. Será útil anexar as configurações de serviço e rede, bem como os logs do sistema e dos serviços.
Para submeter qualquer alteração, como novos recursos, correção de bugs ou melhorias, basta realizar um git clone do repositório, git add quando todas as alterações forem feitas e git commit quando estiver pronto para enviar a alteração.
Durante o envio, certifique-se de que cada alteração esteja associada a uma alteração lógica para que cada alteração seja facilmente identificada.
Na descrição do commit, use o seguinte formato:
[CATEGORY] CHANGE_SHORT_DESCRIPTION OPTIONAL_LONGER_DESCRIPTION SIGNED_OFFS MODIFIED_FILES
Onde:
CATEGORY é: Correção de bug para resolver bugs ou problemas, Melhoria para melhorias de recursos já implementados ou Novo recurso para novos desenvolvimentos que fornecem um novo recurso não implementado antes.
CHANGE_SHORT_DESCRIPTION é uma breve descrição relacionada à alteração aplicada e permite identificar facilmente tal modificação. Se estiver relacionado a um bug incluído na seção Problemas é recomendado incluir a referência de identificação desse bug.
OPTIONAL_LONGER_DESCRIPTION é uma descrição opcional mais longa para explicar detalhes sobre a alteração aplicada.
SIGNED_OFFS é a entrada Signed-off-by onde o nome de usuário seguido do e-mail pode ser colocado.
MODIFIED_FILES são a lista de arquivos que foram modificados, criados ou deletados com o commit.
Normalmente, executar git commit -a -s criará os campos descritos acima.
Por fim, basta executar um git push e solicitar o pull de suas alterações. Além disso, você pode usar git format-patch para criar seus patches e enviá-los através da lista de distribuição oficial.
No wiki oficial do GitHub está disponível uma lista de páginas e suas traduções. Clone o wiki, aplique suas alterações e solicite um pull para que seja aplicado.
A lista de distribuição oficial pode ser acessada através do grupo google skudonet-ce-users.
Para postar neste grupo, envie um e-mail para [email protected].
Mas você precisa primeiro solicitar a adesão ao grupo, enviando um e-mail para [email protected].
Para cancelar a inscrição neste grupo, envie um e-mail para [email protected]
Para mais opções, visite https://groups.google.com/a/skudonet.com/d/optout
