O que é o LDAP?

LDAP é um protocolo de acesso a diretórios leves. ELE NÃO É UM ACTIVE DIRECTORY, ele é um protocolo de busca. Resumidamente, você armazena dados e as aplicações buscam esses dados… bem como se fosse um banco de dados em forma de árvores usado para buscas utimizadas.

Estrutura do LDAP

Deixarei 3 nomenclaturas para exemplicar e resumir boa parte da estrutura do LDAP. Porém, seguiremos com foco na solução OPENLDAP, assim conseguimos seguir uma linha de raciocinio para configuração e exemplo.

• 1 - ObjectClass:
  • É uma CLASSE que contém um conjunto de ATRIBUTOS necessários para criar um dado.
  • Você só pode inserir um dado no LDAP usando uma ObjectClass, e consequentemente, os atributos que ela permitir.
  • Existem dois tipos: AUXILIARY & STRUCTURAL.
  • TODO registro precisa de uma STRUCTURAL.
  • Uma AUXILIARY adiciona novos atributos.

REPRESENTAÇÃO DE UMA CLASSE

• Classe STRUCTURAL

👇🏻 Atributos

NAME: ’nomedaclasse'

SUP: ’top’ (superior a essa classe)

STRUCTURAL: (tipo da classe)

👇🏻 Tipos de atributos que podem ser usados MUST: (tipo must -o dado que obrigariatoriamente deve conter-)

MAY: (tipo may -o que pode passar opcionalmente-)

• Classe AUXILIARY

👇🏻 Atributos

NAME: ’nomedaclasse'

SUP: ’top’ (superior a essa classe)

AUXILIARY: (tipo da classe)

👇🏻 Tipos de atributos que podem ser usados

DESC: (abstracao de uma conta com atributos posix)

MUST: (tipo must -o dado que obrigariatoriamente deve conter-)

MAY: (tipo may -o que pode passar opcionalmente-)

• 2 - Attribute:
  • Os Atributos são o que as ObjectClass tem de informação (conforme exemplo das classes acima). São os dados que a aplicação pode utilizar quando se conectar com o LDAP.

EXEMPLO DE DADOS QUE PODEMOS CONTER NO ATRIBUTO MUST cn=matheus uid=matheus uidNumber=9000 gidNumber=9000 homeDirectory=/home/matheus

• 3 - Schemas:
  • O schema nada mais é como se fosse um plugin, ele é um arquivo que contém a descrição de várias Classes(objectclasses). Exemplo: um arquivo que contenha todas as informações para importar determinado atributo em uma objectclasses (arquivo ldif).

EXEMPLO DE ARVORE LDAP

OPENLDAP

O OpenLDAP é uma solução open source de implementação do LDAP em um ambiente.

ESTRUTURA DO OPENLDAP

• Access Control (ACL) - Controle de quem pode executar qual ação dentro do ldap. Sintaxe do atributo OLC Access (utilizado pelo ACL).

olcAccess: to<what>by<who><accesslevel>

tipos de utilização do "<what>": dn.base=“ou=people,o=suffix” 👈🏻 tudo que esteja no mesmo DN dn.one=“ou=people,o=suffix” 👈🏻 tudo que tenha o DN como pai dn.subtree=“ou=people,o=suffix” 👈🏻 tudo abaixo do DN, incluindo o DN dn.children=“ou=people,o=suffix” 👈🏻 tudo abaixo do DN

tipos de utilização do "<who>":

tipos de permissões do "<accesslevel>":

Conclusão

O LDAP+OpenLDAP é uma excelente maneira para você ter um gerenciamento melhor do seu ambiente. Essa foi uma parte bem teórica sobre o LDAP e o OPENLDAP, possívelmente trarei a parte prática que realizarei em um laboratório e compartilharei com vocês.

Espero ter ajudado a entender um pouco melhor sobre a parte teórica do LDAP.

Abraços do Golden Retriever.

Se você é um usuário novo no Linux e está se habituando a utilizar o shell, porém está cansado da tela preta apenas com as letras brancas sem nenhum tipo de facilidade na hora de executar os comandos, esse artigo é para você! Aqui vou apresentar-lhes o Z Shell e um framework chamado Oh My ZSH, que são de utilidade pública para os usuários Linux, visto a facilidade, simplicidade e grande variedade de recursos disponíveis para a execução de comandos no terminal/CLI.

O que é o Z Shell?

O Z Shell é um interpretador de comandos de shell para sistemas operacionais baseados em Unix, como Linux e macOS. Ele é uma extensão do Bourne Shell (sh) e contém diversos recursos. O ZSH é altamente configurável e pode ser uma escolha popular entre desenvolvedores e usuário avançados de terminal, devido à sua flexibilidade.

Oh My ZSH

Já o Oh My ZSH é um framework de configuração e gerenciamento para o ZSH. Ele foi desenvolvido para simplificar e melhorar a experiência de uso do ZSH, oferecendo uma série de recursos pré-configurados, temas, plugins e uma interface de linha de comando (CLI) para facilitar a personalização do ambiente de shell.

A teoria já foi…

Agora que você já sabe o que é o ZSH e o Oh My ZSH, eu tenho certeza que ficou com interesse em testa-los no seu terminal! Sendo assim, ensinarei a instala-los e configura-los com alguns plugins que utilizo no dia-a-dia.

INSTALAÇÃO ZSH

Utilizaremos uma máquina Ubuntu para realizar a instalação dos pacotes necessários. Sendo assim, inicializaremos com a atualização dos já existentes:

# Atualizando os pacotes já existentes
sudo apt update -y
sudo apt upgrade -y

Com os pacotes atualizados, instalaremos você precisará utilizar em algum momento.

Com excessão do GIT e do CURL, a ferramenta NÃO depende do restante para funcionar.

# Instalando alguns pacotes que você possivelmente precisará utilizar no futuro
sudo apt install dkms make perl gcc build-essential git curl -y

Com esses pacotes baixados e instalados, agora é a vez do ZSH.

# Instalando e configurando o ZSH
sudo apt install zsh -y
chsh -s /bin/zsh # comando para mudar o shell para o ZSH

# Para que funcione automaticamente, basta reiniciar a máquina. Mas caso você opte por não reiniciar e entrar no zsh, basta rodar o comando abaixo:
zsh # Comando para inicar o ZSH.

Note que aparecerá um menu na sua tela. Isso acontece porque ainda não criamos um arquivo .zsh. Sendo assim, basta selecionar a opção q OU apertar ENTER para sair do menu.

Com o zsh funcionando, chegou a hora de configurar o Oh-My-ZSH e deixar o terminal mais bonito e personalizado.

# Instalando Oh-my-ZSH! (https://ohmyz.sh/)
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

No meio da instalação do oh-my-zsh, ele perguntará se vc quer deixar o ZSH como padrão shell, basta você apertar y e ele configurará automaticamente um arquivo .zsh no seu perfil.

Feito isso, você já terá o ZSH instalado e configurado junto ao Oh-My-ZSH. Porém ainda falta configurar alguns plugins que ajudará no seu dia-a-dia com a utilização do CLI. Sendo assim, configuremos dois dos plugins que mais utilizo e que me auxiliam quando utilizo o ZSH.

Primeiro iremos baixar os plugins, que são os:

• AutoSugestions: ele dá algumas sugestões na hora que estou digitando algum comando.
• ZSH-Syntax-Highlighting: esse plugin destaca os comandos enquanto são digitados, por exemplo, caso eu vá utilizar o “curl” e não tenha ele instalado, quando eu digitar o comando “curl”, ele ficará vermelho. Caso eu tenha instalado, ele ficará verde.

# Instalando os plugins
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

# Clonado os repositórios, basta inseri-los no arquivo do .zshrc que está no /home do seu usuário
sudo vim .zshrc

No arquivo do .zshrc, tem o bloco de plugins (aqui está mais ou menos na linha 73), basta inserir o nome dos plugins nesse bloco. Exemplo:

# ARQUIVO .ZSHRC

# Which plugins would you like to load?
# Standard plugins can be found in $ZSH/plugins/
# Custom plugins may be added to $ZSH_CUSTOM/plugins/
# Example format: plugins=(rails git textmate ruby lighthouse)
# Add wisely, as too many plugins slow down shell startup.
plugins=(
        git
        zsh-autosuggestions
        zsh-syntax-highlighting
        )

source $ZSH/oh-my-zsh.sh

Adicionado os plugins no arquivo .zshrc, eles já estarão funcionando. Caso você opte por personalizar ainda mais o ZSH com Oh-my-ZSH, recomendo acessar ESSE REPOSITÓRIO e ver qual plugin mais te agrada ou auxiliará durante a utilização da CLI.

CONCLUSÃO

Realizado todas as etapas do hands-on, espero poder ter ajudado a personalizar e melhorar a agilidade sua com seu terminal. E que você goste cada vez mais de CLI.

Abraços do Golden Retriever.

O que é o LVM?

O LVM (Logical Volume Management - Gerenciamento de Volume Lógico), é uma tecnologia de gerenciamento de armazenamento usada em sistemas Linux e que permite gerenciar o espaço em disco de forma mais flexível.

Um bom exemplo, é a possibilidade da criação de Volumes Lógicos (VG) que podem abranger vários discos físicos, permitindo redimensionar, mover e criar Volumes Lógicos sem precisar desligar o sistema ou mover dados.

Estrutura do LVM

A estrutura do LVM consiste em alguns principais componentes, sendo eles:

• Physical Volumes (PVs): São os discos físicos ou partições de disco que são incorporados ao pool de armazenamento gerenciado pelo LVM. Um PV pode ser um disco inteiro ou uma partição em um disco.

• Volume Groups (VGs): Um VG é uma coleção de um ou mais PVs (physical volumes). Ele funciona como um pool de armazenamento lógico a partir do qual os Volumes Lógicos são criados. O espaço de armazenamento em todos os PVs pertencentes a um VG é combinado e disponibilizado para alocação.

• Logical Volumes (LVs): São volumes lógicos que são crioados dentro de um VG. Eles são equivalentes a partições em um sistema de arquivos tradicional, mas com a vantagem de que podem ser redimensionados de forma dinâmica e não estão vinculados a um único Physical Disk (PV). Os LVs são o que os sistemas operacionais enxergam e utilizam como dispositivos de armazenamento.

• Extents: Não menos importante, os extents são pequenos blocos que o LVM divide o espaço de armazenamento. Esses extents são a menor unidade de alocação e podem variar de tamanho dependendo da configuração do LVM.

Hands-on LVM

No exemplo do hands-on, iremos expandir uma partição (/var) adicionando um novo disco á máquina (/dev/sdb).

Os comandos utilizados funcionam nas distribuições em Ubuntu e CentOS. Nesse ponto, é importante e necessário que você já tenha adicionado um novo disco na sua máquina, seja ela bade metal ou virtual. Para listar os discos e partições, iremos rodar o seguinte comando:

Comandos executados como superusuário.

fdisk -l

A máquina nos retornará os discos e suas partições. Suponhamos que seja o segundo disco que esteja adicionando na máquina e é por isso que ele será o /dev/sdb.

Como estamos com um novo disco, precisamos criar uma nova partição para que possamos seguir com a expansão do /var. Para criar uma partição:

# setando o disco que iremos criar a partição lógica
fdisk /dev/sdb

# comandos para seguir dentro do menu do FDISK
n # criar nova partição
p # dizendo que é uma partição primaria

# AS OPÇÕES DO TAMANHO PODE DEIXAR PADRÃO, VISTO QUE UTILIZAREMOS TODOS OS SETORES DO DISCO.

Ainda no FDISK, depois de criado a partição lógica, é necessário setar que será uma partição do tipo LVM:

# No FDISK
t # para alterar o tipo de partição
8e # o código da partição do tipo LVM
w # para gravar todas as modificações que realizamos no /dev/sdb

Depois de gravar todas as modificações realizadas no disco /dev/sdb, ou seja, a criação da nova partição lógica e a alteração do tipo de partição, caso executemos o comando fidsk -l novamente, ele nos retornará a partição criada, sendo ela /dev/sdb1.

Agora precisamos criar o Physical Volume com a partição lógica que criamos. Execute o comando:

# criando o Physical Volume
pvcreate /dev/sdb1

Com o PV criado, para localizarmos o LV que iremos expandir, execute:

# localizando o LV a ser expandido
lvdisplay

Como dito anteriormente, será o /var. E é de extrema importância que você salve as informações LV Path e VG Name que serão exibidas no seu terminal.

No meu exemplo, os dados serão:

LV Path ———- /dev/vg0/lv-0-var VG Name ——— vg0

Com essas informações, podemos dar continuidade e então realizar utilizar o comando vgextend para estender o Volume Group, utilizando o Physical Volume que criamos. Para isso:

# estendendo o VG com o PV criado
vgextend vg0 /dev/sdb1

Utilizaremos todo o espaço livre o alocando ao LV Path:

lvextend -l +100%FREE /dev/vg0/lv-0-var

Verifique o sistema de arquivos utilizado no seu filesystem, no exemplo, estamos utilizando o ext4.

# para verificar o sistema de arquivos
df -hT

• Caso seja EXT4, para expandir automaticamente o espaço existente:

resize2fs -p /dev/vg0/lv-0-var

• Caso seja XFS, para expandir a partição:

xfs_growfs /dev/vg0/lv-0-var

Para validar a expanção, execute o seguinte comando:

# validando se houve a expanção da partição
df -h

Conclusão

Em conclusão, o LVM é uma ferramenta poderosa para gerenciamento de armazenamento em sistemas Linux, possibilitando uma maior flexibilidade e eficiência na alocação e gerenciamento de espaço em disco.

Espero ter ajudado a entender um pouco sobre o funcionamento e a estrutura do LVM.

Abraços do Golden Retriever.

Site Estático

O que é um site estático? Um site estático nada mais é do que um código HTML que se hospeda em algum lugar, não sendo necessário banco de dados, plugins e afins para que o site funcione. Dessa maneira, conseguimos uma boa perfomance quando comparado a um Content Management System (CMS).

Hugo Framework

O Hugo Framework é um framework desenvolvido em GO, e não é necessário você saber desenvolver em GO para utiliza-lo, apenas mudando alguns parametros simples o site é gerado, depois de gerado ele é compilado e enviado para a hospedagem. Simples, rápido e prático!

Com o Hugo Framework, você consegue escrever posts no formato Markdown, que quando compilado, vira HTML.

Git Workflow

O Github Workflow (Github Actions) é uma plataforma de integração contínua e entrega contínua (CI/CD), que nos permite automatizar compilações, nada mais é do que uma pipeline de implantação.

Cloudflare

A Cloudflare é uma provedora de serviços mais conhecida por seu CDN, mas que também nos permite fazer toda a parte de compilação do código que iremos utilizar para nosso site estático.

HANDS-ON

Agora, vou tentar explicar o que realmente foi feito na prática para que o blog funcionasse.

Antes de mais nada, caso você queira realizar os mesmos passos que eu fiz, certifique-se de que você tenha conta no Github e na Cloudflare.

Utilizei uma máquina com ubuntu server para realizar todo esse projeto.

Certo disso, iremos iniciar realizando a instalação do hugo:

sudo apt install hugo

Realizado a instalação do Hugo, basta você começar utiliza-lo iniciando o projeto:

hugo new site <NomeProjeto> # onde tem <NomeProjeto> é onde você irá inserir o nome do seu projeto/site exemplo "hugo new site zollitech"

Iniciado o projeto, se você listar os diretórios com o comando “ls”, verá que foi criado uma pasta contendo todo o conteúdo necessário para seu site estático.

Basicamente teremos o archetypes, content, data, layouts, static, themes e o arquivo padrão do site config.toml ou hugo.toml, depende da versão do hugo que está utilizando.

Sobre a estrutura:

• archetypes - basicamente o cabeçalho de todo arquvio .md do site.
• content - onde ficam as páginas do site.
• layout - onde ficam os conteúdos em HTML.
• static - onde ficam os conteúdos CSS.
• themes - onde fica a pasta do tema utilizado para o site.

Conhecendo toda estrutura, já podemos dar inicio para a escolha do tema que utilizaremos no blog.

Escolha um tema no SITE DE TEMAS DO HUGO. Geralmente na própria página do tema tem a maneira de instalação, mas como abordado no inicio do post, irei mostrar os passos que realizei para que o MEU site funcionasse.

Após escolher o tema, no meu terminal, rodei um comando para adicionar o tema como um submódulo do repositório, sendo assim, na pasta raiz do projeto:

git init # para iniciar o git
git submodule add https://github.com/rhazdon/hugo-theme-hello-friend-ng.git themes/hello-friend-ng # esse é o tema que utilizei no meu blog, mas caso queira outro, é só passar a url dele junto ao comando submodule add.

# Executando esse comando, ele realizará um clone do repositório do tema e adicionará como um módulo no diretório themes/hello-friend-ng

Depois de realizar o clone, vamos substituir os arquivos que vieram por padrão quando inicializamos o projeto, pelos arquivos do tema:

cp -r ./themes/hello-friend-ng/exampleSite/* .

Esse comando copiou recursivamente tudo o que continha no diretório do tema para nosso diretório atual (raiz do site).

Dessa maneira, já conseguimos ter uma visão de como o site está ficando, basta rodar o seguinte comando:

hugo server -D

Caso você esteja hospedando em outra máquina e precise acessar por outro IP, utilize o comando:

hugo server --bind=<IP_VM> --baseURL=http://<IP_VM>:1313 # no campo <IP_VM> você adicionará o ip da vm que está hospedando o Hugo.

Assim você já consegue ir realizando as alterações no arquivo config.toml ou hugo.toml e no browser acessar o IP:1313 para visualizar seu site estático.

Caso você utilize o serviço da Netlify ao invés do Cloudflare, será necessário criar um arquivo de configuração .toml para tal. Aqui realizaremos o processo voltado para a Cloudflare.

A PARTIR DESSA ETAPADA, IREMOS COMEÇAR UTILIZAR O GITHUB E CLOUDFLARE

NO GITHUB

Crie o repositório com o nome do seu projeto (pode ser público). Caso optar por um repositório privado, terá que pagar para utilizar o GithubActions da maneira que vamos usar aqui no tutorial.

Com o repositório já pronto e com o mesmo nome do seu projeto do hugo, tendo em vista que você já realizou as alterações do site nos arquivos do projeto, basta commita-las em seu repositório novo do git.

git add .
git commit -m "first commit"
git remote add origin <url do repositório> # adicionei a url .git do seu repo
# coloque as credenciais do teu github

Bingo! Teu repositório já estará pronto para ser compilado na Cloudflare.

CLOUDFLARE

No painel da CloudFlare, faça os seguintes passos:

• Faça os apontamentos DNS para o seu dominio.
• Tendo em vista que já tem os apontamentos DNS, na opção Workers e Pages do menu principal, clique na opção “Crie um aplicativo”.
• Depois, clique na aba “Pages” e vá até a opção de “Criar importando um repositório Git existente”.
• Ele solicitará para conectar/integrar sua conta do github com o cloudflare. No github terá a opção de selecionar apenas o repositório do seu projeto, faça isso.
• Na etapa de Build Settings, selecione a opção do HUGO FRAMEWORK.
• Dessa forma você pode selecionar a opção de “Save and Deploy”.

Pode ser que durante o deploy, dê algum erro e na grande maioria das vezes, é por conta da versão do Hugo Framework. Nos próximos passos ensinarei a setar a versão do Hugo que você está usando no seu computador, na Cloudflare.

Depois que você configurou toda a parte do Pages no Cloudflare, você verá seu “aplicativo” na aba do Workers e Pages, lá você conseguirá editar o seu projeto.

Clicando em “Editar”, haverá a opção “Settings”, na opção settings você consegue definir algumas váriveis ambientes (environment variables) e é nessa parte que setamos as configurações do Hugo Framework.

Nessa etapa, recomendo que você configure duas váriaveis ambientes, sendo elas:

Para saber qual a versão do hugo framework que está utilizando no seu computador, rode o comando:

hugo version # Esse comando deve ser executado no seu computador onde está instalado o hugo framework

Feito isso, salve as configurações no botão “Save” e refaça o deploy do aplicativo novamente na “Deployments”,

Feito o deploy e tudo funcionando, vamos apontar o “aplicativo” para o nosso dominio registrado na cloudflare.

Para realizar esse procedimento, no mesmo menu do aplicativo na cloudflare, vá na opção/aba “Custom domains” e clique em “Set up a custom domain”.

Nessa opção, inserimos nosso dominio desejado, clicamos em “Continue” e ele apresentará um apontamento CNAME para o dns conteúdo do “aplicativo”, basta clicar em “ACtivate Domain” para concluirmos o apontamento do nosso dominio para o aplicativo.

Se tudo estiver configurado de maneira certa, CONCLUIMOS todos os passos para configuração do seu site estático.

Para realizar alterações no site, basta realizar um commit na master do seu projeto no Github, assim o Cloudflare executará toda compilação para que faça as alterações e a publique na internet.

Caso não saiba commitar, basta executar os seguintes comandos:

git add .
git commit -m "descricao do commit"
git push -u origin master

Qualquer dúvida referente esses processos, me chame em alguma de minhas redes sociais. Estarei à disposição.

Linkedin Instagram

Deixo aqui alguns vídeos de referência para esse projeto:
Deploy A Static Site Using DevOps with Hugo Cloudflare And Github
Como criar um site/blog com HUGO framework

Abraços do Golden Retriever.

MAAS ou Metal as a Service (Metal como Serviço) é uma ótima ferramenta da Canonical, capaz de provisionar máquinas bare metal, bem como máquinas virtuais. Essa tool permite implantar Windows, Linux, ESXi e muitos outros sistemas operacionais, ajudando você a construir uma “nuvem” bare metal.

INSTALAÇÃO

Nesse cenário instalarei o MAAS em uma máquina Ubuntu Server 22.04 Jammy. Logo no inicio, tive alguns problemas com a instalação utilizando o apt e por isso optei pela instalação utilização o snapd, sendo assim, caso você não tenha o snapd instalado, utilize o comando:

sudo apt install snapd

Agora, iniciaremos o processo de construção do MAAS, para isso primeiro realizaremos o download da versão 3.4 (atualmente a mais estável):

sudo snap install --channel=3.4 maas

O MAAS é um serviço que necessita de um banco de dados, para isso, utilizaremos o postgres. Caso você já possua o postgres em seu ambiente, pule essa etapa. Mas caso desejar utilizar um banco de dados de teste MAAS:

sudo snap install maas-test-db

testando o banco de dados:

sudo maas-test-db.psql

INICIALIZANDO O MAAS

Caso esteja utilizando o banco de dados acima, inicialize o MAAS:

sudo maas init region+rack --database-uri maas-test-db:///

Caso você já utilize o postgres em seu ambiente, poderá inicializar o MAAS usando o seu próprio serviço postgres. Certifique-se de criar o banco de dados, o usuário e atribuir ermissões a esse usuário antes de executar o comando init.

sudo maas init region+rack --database-uri "postgres://username:password@<IP_MAAS>/maas" # replace with username /password / ip /db name

Caso não deseje armazenar suas secrets no histórico do terminal, considere utilizar variáveis ENV:

sudo maas init region+rack --database-uri "postgres://$MAAS_DBUSER:$MAAS_DBPASS@$HOSTNAME/$MAAS_DBNAME"

Para acessar o MAAS, precisamos antes, criar uma conta de administrador:

sudo maas createadmin

OBSERVAÇÕES

Futuramente farei alguns testes utilizando a ferramenta Packer, da Hashicorp, para aumentar a possibilidades de imagens para o provisionamento de novas máquinas virtuais. Mas esse post é exclusivamente sobre o Metal as a Service.

REFERÊNCIAS

Documentação MAAS

Referência de Tutorial (technotim)