From 97a832dfff9f5d53a812c6c4e347fea5a780a613 Mon Sep 17 00:00:00 2001
From: Silvio Rhatto <rhatto@riseup.net>
Date: Fri, 11 Apr 2025 08:55:11 -0300
Subject: Link fixes

---
 docs/backup.md          | 10 +++++-----
 docs/backup/methods.md  |  2 +-
 docs/bootstrap.md       | 21 +++++++++++----------
 docs/boxes.md           |  2 +-
 docs/certs.md           |  2 +-
 docs/cryptocalypse.md   |  6 +++---
 docs/domains.md         |  4 ++--
 docs/firewall.md        | 26 +++++++++++++++++---------
 docs/index.md           |  2 +-
 docs/install.md         | 13 ++++++-------
 docs/keys.md            |  4 ++--
 docs/nodo.md            |  4 ++--
 docs/nodo/allocation.md |  2 +-
 docs/provision.md       |  2 +-
 14 files changed, 54 insertions(+), 46 deletions(-)

diff --git a/docs/backup.md b/docs/backup.md
index 657262c..f54d45e 100644
--- a/docs/backup.md
+++ b/docs/backup.md
@@ -1,7 +1,7 @@
 # Backup
 
-* [Conceitos](concepts).
-* [Convenções](conventions).
-* [Métodos](methods).
-* [Restauração](restore).
-* [Migração de sites](migration).
+* [Conceitos](backup/concepts.md).
+* [Convenções](backup/conventions.md).
+* [Métodos](backup/methods.md).
+* [Restauração](backup/restore.md).
+* [Migração de sites](backup/migration.md).
diff --git a/docs/backup/methods.md b/docs/backup/methods.md
index 456e372..f32a09e 100644
--- a/docs/backup/methods.md
+++ b/docs/backup/methods.md
@@ -8,7 +8,7 @@ armazenamento de backups, divididos nas partes:
 
 A discussão aqui não tem caráter prático mas meramente teórico, sem menção às
 implementações dos métodos. Para isso, veja a página
-[Convencoes](../conventions).
+[Convencoes](conventions.md).
 
 ## Métodos de transferência
 
diff --git a/docs/bootstrap.md b/docs/bootstrap.md
index 653f517..f95baa0 100644
--- a/docs/bootstrap.md
+++ b/docs/bootstrap.md
@@ -1,7 +1,7 @@
 # Bootstrap de uma configuração completa
 
 Este documento tem como objetivo descrever o **processo de bootstrap** de uma
-configuração completa de um servidor utilizando o [Padrão Saravá](/). O
+configuração completa de um servidor utilizando o [Padrão Fluxo](index.md). O
 *processo de bootstrap* pode ser compreendido como "o processo de coordenar
 diversos processos interdepententes de forma que seja atingida uma configuração
 sistêmica estável".
@@ -11,8 +11,8 @@ Para este processo, utilizaremos as seguintes ferramentas:
 * [Debian GNU/Linux 6.0](http://www.debian.org/releases/squeeze/).
 * [Linux-VServer](http://linux-vserver.org/) ([pacote do debian](http://packages.debian.org/squeeze/linux-image-2.6-vserver-686)).
 * [Git](http://git-scm.com/) e [gitosis](http://swik.net/gitosis).
-* [puppet-bootstrap](http://git.sarava.org/?p=puppet-bootstrap.git;a=summary).
-* [hydra](http://git.sarava.org/?p=hydra.git;a=summary).
+* [puppet-bootstrap](http://git.fluxo.info/puppet-bootstrap).
+* [hydra](http://git.fluxo.info/hydra).
 
 Os seguintes estágios fazem parte de uma instalação padrão completa:
 
@@ -39,7 +39,7 @@ Configure o arquivo `/etc/hosts` (a ordem dos hostnames influencia nos resultado
 Instale o git e o puppet e clone o repositório `puppet-bootstrap`:
 
     apt-get -y install git-core puppet wipe
-    git clone git://git.sarava.org/puppet-bootstrap ${puppet_bootstrap_dir}
+    git clone git://git.fluxo.info/puppet-bootstrap ${puppet_bootstrap_dir}
 
 Altere o arquivo `${puppet_bootstrap_dir}/manifests/config.pp` de acordo com suas necessidades.
 
@@ -151,11 +151,11 @@ Instale `hydra` e `keyringer`:
 
     sudo apt-get -y install git-core
     # hydra
-    sudo git clone git://git.sarava.org/hydra /usr/local/hydra
+    sudo git clone git://git.fluxo.info/hydra /usr/local/hydra
     sudo ln -sf /usr/local/hydra/hydra /usr/local/sbin/hydra
     sudo ln -sf /usr/local/hydra/hydra /usr/local/sbin/hydractl
     # keyringer
-    sudo git clone git://git.sarava.org/keyringer /usr/local/keyringer
+    sudo git clone git://git.fluxo.info/keyringer /usr/local/keyringer
     sudo ln -sf /usr/local/keyringer/keyringer /usr/local/bin/keyringer
 
 Tenha certeza que possui em seu chaveiro gpg as chaves dos usuários que irão
@@ -181,7 +181,6 @@ Gere novas chaves para os nós configurados e as envie para os nós:
     hydra projeto newkeys
     hydra projeto import servidor.pub
 
-
 ## Partida do puppetmaster
 
     /etc/init.d/puppetmaster start
@@ -212,15 +211,17 @@ Gere novas chaves para os nós configurados e as envie para os nós:
     git init
     git add .
 
-    repos="`lynx -dump http://git.sarava.org/?a=project_index | awk '{ print $1 }' | grep ^puppet-`"
+    # FIXME: this needs update
+    repos="`lynx -dump http://git.fluxo.info/?a=project_index | awk '{ print $1 }' | grep ^puppet-`"
+
     for repo in $repos; do
       module="`basename $repo .git | sed -e s/^puppet-//`"
       if [ ! -d "modules/$module" ]; then
-        git submodule add git://git.sarava.org/puppet-$module.git modules/$module
+        git submodule add git://git.fluxo.info/puppet-$module.git modules/$module
       fi
     done
 
-No caso de bootstrap para um novo projeto, substitua as referências de `git.sarava.org` para `git.projeto.org`.
+No caso de bootstrap para um novo projeto, substitua as referências de `git.fluxo.info` para `git.projeto.org`.
 
 ### Configurando referências remotas em massa
 
diff --git a/docs/boxes.md b/docs/boxes.md
index dcd7550..4154695 100644
--- a/docs/boxes.md
+++ b/docs/boxes.md
@@ -38,7 +38,7 @@ com isto no `/root/.profile`:
 Você já pode parar por aí pois já tem uma máquina bem genérica ou começar a customizar
 a máquina para ter ferramentas e configurações comuns para o seu dia dia.
 
-Por exemplo, considere a [instalação](/install) da Hydra Suite na máquina virtual.
+Por exemplo, considere a [instalação](install.md) da Hydra Suite na máquina virtual.
 
 ## Encolhendo uma máquina virtual
 
diff --git a/docs/certs.md b/docs/certs.md
index 9fc1a04..87f1b78 100644
--- a/docs/certs.md
+++ b/docs/certs.md
@@ -2,7 +2,7 @@
 
 ## Começando
 
-Proceda com a [configuração do ambiente de trabalho administrativo](/install).
+Proceda com a [configuração do ambiente de trabalho administrativo](install.md).
 
 ## Gerando novas chaves
 
diff --git a/docs/cryptocalypse.md b/docs/cryptocalypse.md
index 2e97969..1dc19f8 100644
--- a/docs/cryptocalypse.md
+++ b/docs/cryptocalypse.md
@@ -4,7 +4,7 @@ Procedimento emergencial de rotação de chaves. Ou, como sobreviver a brechas d
 
 ## Começando
 
-Proceda com a [configuração do ambiente de trabalho administrativo](/install).
+Proceda com a [configuração do ambiente de trabalho administrativo](install.md).
 
 ## Atualizando
 
@@ -27,11 +27,11 @@ Para cada nodo usado no git público:
 
 ## Chaves do Puppet
 
-[Reset da infra de CA do puppet](certs/puppet).
+[Reset da infra de CA do puppet](bootstrap.md).
 
 ## Certificados SSL
 
-[Gere novos certificados SSL](certs).
+[Gere novos certificados SSL](certs.md).
 
 ## Chaves SSH dos ikiwikis
 
diff --git a/docs/domains.md b/docs/domains.md
index aeaea1d..bc37ec8 100644
--- a/docs/domains.md
+++ b/docs/domains.md
@@ -2,11 +2,11 @@
 
 ## Começando
 
-Proceda com a [configuração do ambiente de trabalho administrativo](/install).
+Proceda com a [configuração do ambiente de trabalho administrativo](install.md).
 
 ## Checando expiração em massa
 
-Necessita o script [domain-check](https://git.sarava.org/?p=puppet-domain_check.git):
+Necessita o script [domain-check](https://git.fluxo.info/puppet-domain_check):
 
     cd $FOLDER/puppet/modules/site_nginx/files
 
diff --git a/docs/firewall.md b/docs/firewall.md
index 37621ea..66a1e40 100644
--- a/docs/firewall.md
+++ b/docs/firewall.md
@@ -1,4 +1,20 @@
-# Configuração do shorewall 
+# Configuração do shorewall
+
+## Introdução
+
+Este é um roteiro emergencial para a cofiguração manual de firewall,
+para situações em que não haja configuração automatizada já disponível.
+
+Uma vez que o [bootstrap](bootstrap.md) estiver concluído, os módulos
+[puppet-firewall](https://git.fluxo.info/puppet-firewall) e
+[puppet-shorewall](http://git.fluxo.info/puppet-shorewall) e poderão ser
+utilizados para gerenciar o firewall.
+
+No entanto, se você for substituir o presente procedimento pela sua versão
+automatizada, certifique-se de apagar os arquivos
+`/etc/shorewall/{masq,policy,zones,rules,interfaces}`.
+
+## Procedimento
 
 De início, instale o shorewall:
 
@@ -70,11 +86,3 @@ Habilite o shorewall mudando o valor de startup de `/etc/default/shorewall` para
 Finalmente podemos ligar o shorewall:
 
     /etc/init.d/shorewall start
-
-## Shorewall e Puppet 
-
-Uma vez que um nodo [puppetmaster](../puppet) estiver rodando, o módulo
-[puppet-shorewall](http://git.sarava.org/?p=puppet-shorewall.git;a=summary)
-poderá ser utilizado para gerenciar o firewall. No entanto, se você for
-substituir o presente procedimento pela sua versão via puppet, certifique-se de
-apagar os arquivos `/etc/shorewall/{masq,policy,zones,rules,interfaces}`. 
diff --git a/docs/index.md b/docs/index.md
index 2105e4b..4108726 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -17,7 +17,7 @@ padrão foi desenvolvido para:
   virtuais.
 * Tornar a instalação dos servidores facilmente replicável.
 
-Originalmente [Padrão Saravá][], agora Padrão em [fluxo][]
+Originalmente [Padrão Saravá][], agora Padrão em [fluxo][].
 
 [Padrão Saravá]: https://web.archive.org/web/20150525110557/https://padrao.sarava.org/
 [fluxo]: https://fluxo.info
diff --git a/docs/install.md b/docs/install.md
index 508649a..8587467 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -1,16 +1,15 @@
 # Instalação da Hydra Suite
 
-Atualmente o Padrão Saravá utiliza a [Hydra
-Suite](http://git.sarava.org/?p=hydra.git;a=summary) para fazer o
-provisionamento. Versões anteriores deste documento não o utilizam, são mais
-descritivas e talvez até mais interessantes ao público interessado nos
-pormenores do procedimento de instalação.
+Atualmente o Padrão Saravá utiliza a [Hydra Suite](http://git.fluxo.info/hydra)
+para fazer o provisionamento. Versões anteriores deste documento não o
+utilizam, são mais descritivas e talvez até mais interessantes ao público
+interessado nos pormenores do procedimento de instalação.
 
 A Hydra Suite pode ser obtida e instalada diretamente do seu repositório:
 
-    git clone --recursive git://git.sarava.org/hydra.git
+    git clone --recursive git://git.fluxo.info/hydra.git
 
-Verifique a [integridade do código](https://manual.sarava.org/specs/code/):
+Verifique a [integridade do código](https://plano.autodefesa.org/specs/code.html):
 
     cd hydra
     tag="`git describe --abbrev=0 --tags`"
diff --git a/docs/keys.md b/docs/keys.md
index 188037f..41c77b8 100644
--- a/docs/keys.md
+++ b/docs/keys.md
@@ -9,7 +9,7 @@ A maior parte dos procedimentos a seguir depende do aplicativo
 Suite](http://git.fluxo.info/?p=hydra.git;a=summary) e de uma configuração do
 tipo
 
-Proceda então com a [configuração do ambiente de trabalho administrativo](/install).
+Proceda então com a [configuração do ambiente de trabalho administrativo](install.md).
 
 ### Inicializando um repositório
 
@@ -141,7 +141,7 @@ Hashes para `htpasswd` são descritos [aqui](http://sarava.fluxo.info/Ajuda/Prot
 
 ## Chave OpenPGP de Coletivo
 
-Vide [Chave OpenPGP de Coletivo](role).
+Vide [Chave OpenPGP de Coletivo](keys/role.md).
 
 ## Cerbot
 
diff --git a/docs/nodo.md b/docs/nodo.md
index 77bbd85..db1bf5a 100644
--- a/docs/nodo.md
+++ b/docs/nodo.md
@@ -40,13 +40,13 @@ Esta consiste na criação do nodo -- máquina virtual ou servidor físico, pode
 ser feita de dois modos:
 
 * Via puppet na própria infraestrutura da `$hydra`.
-  * No caso de um servidor físico, proceda [apropriadamente](/install).
+  * No caso de um servidor físico, proceda [apropriadamente](install.md).
   * No caso de uma máquina virtual, defina-a no manifest do puppet da máquina
     hospedeira usando o padrão de virtualização desejado.
 * Solicitando a um coletivo hospedeiro altamente confiável.
 
 No caso de uma máquina virtual hospedada numa máquina física do grupo,
-considere a [faixa de alocação](allocation) de IPS.
+considere a [faixa de alocação](nodo/allocation.md) de IPS.
 
 ### Definição do nodo
 
diff --git a/docs/nodo/allocation.md b/docs/nodo/allocation.md
index ff4c368..314a63f 100644
--- a/docs/nodo/allocation.md
+++ b/docs/nodo/allocation.md
@@ -38,4 +38,4 @@ Ou seja,
  * Sempre que houvesse uma máquina virtual do grupo Y numa maquina, seria
    sempre no contexto 42, IP interno 192.168.0.42, porta 2242.
  * Já o nome da máquina virtual mudaria sempre, eventualmente seguindo o padrao
-   do [puppet-bootstrap](https://git.sarava.org/?p=puppet-bootstrap.git).
+   do [puppet-bootstrap](https://git.fluxo.info/puppet-bootstrap).
diff --git a/docs/provision.md b/docs/provision.md
index 228452d..9b899a2 100644
--- a/docs/provision.md
+++ b/docs/provision.md
@@ -6,7 +6,7 @@ USB.
 
 ## Instalação 
 
-Após a [instalação da Hydra Suite](/install), basta iniciar o procedimento com
+Após a [instalação da Hydra Suite](install.md), basta iniciar o procedimento com
 os devidos privilégios administrativos (como `root` ou usando o `sudo`):
 
     hydractl provision
-- 
cgit v1.2.3