Feat/local development feature

Guide-Local-development.md

@@ -0,0 +1,164 @@
+# Guide Local Development
+
+Este documento explica o processo de desenvolvimento local do DevPortal com suporte completo a plugins dinâmicos.
+
+## Pré-requisitos
+
+### Dependências Obrigatórias
+
+1. **Node.js** (versão 20 ou 22)
+2. **Yarn** (versão 4.4.1+)
+3. **Python 3** (para execução do script de plugins)
+4. **Make** (para build do projeto)
+
+### Dependências para Plugins OCI
+
+Para usar plugins baseados em container OCI, você precisa instalar:
+
+1. **Skopeo** - Ferramenta para trabalhar com registries de container
+   ```bash
+   # Ubuntu/Debian
+   sudo apt-get install skopeo
+
+   # macOS (via Homebrew)
+   brew install skopeo
+
+   # RHEL/CentOS/Fedora
+   sudo dnf install skopeo
+   ```
+
+2. **Docker** (opcional, mas recomendado para desenvolvimento)
+   - Necessário se você quiser testar plugins OCI localmente
+   - Registro Docker deve estar acessível
+
+### Verificação de Dependências
+
+```bash
+# Verificar se todas as dependências estão instaladas
+node --version    # Deve ser 20.x ou 22.x
+yarn --version    # Deve ser 4.4.1+
+python3 --version # Deve ser 3.x
+make --version    # Deve estar disponível
+skopeo --version  # Necessário apenas para plugins OCI
+```
+
+## Arquitetura de Plugins Dinâmicos
+
+### Arquivos de Configuração
+
+1. **`dynamic-plugins.default.yaml`**
+   - Contém plugins **embutidos** na aplicação base
+   - Inclui plugins de frontend e backend pré-configurados
+   - Plugins locais (caminhos `./dynamic-plugins/dist/...`)
+   - Configurações padrão para desenvolvimento
+
+2. **`dynamic-plugins.yaml`**
+   - Contém plugins **externos** (OCI e NPM)
+   - Inclui referência ao `dynamic-plugins.default.yaml` via `includes`
+   - Suporta plugins de container OCI (`oci://docker.io/...`)
+   - Suporta plugins NPM remotos e locais
+   - Configurações específicas de montagem e comportamento
+
+### Sistema de Instalação de Plugins
+
+O script `check_dynamic_plugins.py` implementa um sistema robusto de gerenciamento de plugins:
+
+#### Funcionalidades Principais
+
+1. **Download e Instalação**
+   - **Plugins OCI**: Usa `skopeo` para baixar imagens de container
+     - Requer `skopeo` instalado no sistema
+     - Suporta registries Docker (`docker://`) e OCI (`oci://`)
+     - Exemplo: `oci://docker.io/user/plugin:v1.0.0!path/in/container`
+   - **Plugins NPM**: Usa `npm pack` para baixar pacotes
+     - Funciona com registries NPM públicos e privados
+     - Exemplo: `@backstage/plugin-catalog` ou `./local-plugin`
+   - **Plugins Locais**: Suporta caminhos relativos (`./`)
+     - Para desenvolvimento local de plugins
+     - Exemplo: `./dynamic-plugins/dist/my-plugin`
+
+2. **Verificação de Integridade**
+   - Validação de hash SHA para pacotes remotos
+   - Verificação de assinatura de pacotes OCI
+   - Proteção contra zip bombs (limite de 20MB por arquivo)
+
+3. **Gerenciamento de Estado**
+   - Sistema de lock para evitar instalações concorrentes
+   - Cache inteligente baseado em hash de configuração
+   - Políticas de pull: `IfNotPresent`, `Always`
+   - Detecção automática de mudanças na configuração
+
+4. **Geração de Configuração**
+   - Cria `app-config.dynamic-plugins.yaml` automaticamente
+   - Merge de configurações de plugins individuais
+   - Resolução de conflitos de configuração
+
+#### Estrutura de Diretórios
+
+```
+dynamic-plugins-root/
+├── app-config.dynamic-plugins.yaml  # Config gerada automaticamente
+├── plugin-name-1/                   # Plugin instalado
+│   ├── dynamic-plugin-config.hash   # Hash da configuração
+│   └── ... (arquivos do plugin)
+└── plugin-name-2/
+    ├── dynamic-plugin-image.hash    # Hash da imagem OCI
+    └── ... (arquivos do plugin)
+```
+
+### Scripts de Desenvolvimento
+
+1. **`yarn init-local`**
+   - Executa build completo (`make full`)
+   - Instala plugins dinâmicos (`yarn check-dynamic-plugins`)
+   - Inicia aplicação em modo desenvolvimento (`yarn dev-local`)
+
+2. **`yarn dev-local`**
+   - Inicia backend e frontend
+   - Carrega configurações: `app-config.local.yaml` + `app-config.dynamic-plugins.yaml`
+   - Suporte completo a hot-reload
+
+3. **`yarn check-dynamic-plugins`**
+   - Executa `scripts/check_dynamic_plugins.sh`
+   - Chama o script Python para instalação de plugins
+
+> **Nota**: Se necessário, dar permissão de execução ao script:
+   ```bash
+   chmod +x ./scripts/check_dynamic_plugins.sh
+   ```
+
+## Configurações Específicas
+
+### Branding e Temas
+
+No `app-config.yaml`:
+- **Logo dinâmico**: Suporte a variantes `light` e `dark`
+- **Tema personalizado**: Configuração `appBarBackgroundScheme` para controle de tema
+- **Largura customizável**: `fullLogoWidth` para ajuste de dimensões
+
+### Autenticação
+
+- Método customizado para autenticação GitHub (desenvolvimento)
+- Configuração de chaves de serviço para autenticação backend
+
+### Componentes
+
+- **Root Component**: Lógica para ocultar logo duplicado quando o ponto de montagem `CompanyLogo` tiver conteúdo para o `logo.light` e `logo.dark`;
+- **CompanyLogo**: Suporte completo a logos temáticos e configuração dinâmica
+
+## Como Usar
+
+1. **Desenvolvimento Local Completo**:
+   ```bash
+   yarn init-local
+   ```
+
+2. **Apenas Instalar Plugins**:
+   ```bash
+   yarn check-dynamic-plugins
+   ```
+
+3. **Desenvolvimento sem Reinstalar Plugins**:
+   ```bash
+   yarn dev-local
+   ```

app-config.yaml

@@ -5,8 +5,9 @@ app:
     ga4:
       measurementId: soueu
   branding:
-    fullLogo: https://veecode-platform.github.io/support/logos/logo.svg
-    fullLogoDark: https://veecode-platform.github.io/support/logos/logo-black.svg
+    fullLogo:
+      light: https://veecode-platform.github.io/support/logos/logo-black.svg
+      dark: https://veecode-platform.github.io/support/logos/logo.svg
     iconLogo: https://veecode-platform.github.io/support/logos/logo-mobile.png
     fullLogoWidth: 150
     theme:
@@ -15,11 +16,13 @@ app:
         palette:
           navigation:
             background: "#222222" # your fixed light theme sidebar background
+            appBarBackgroundScheme: light
       dark:
         variant: "backstage"
         palette:
           navigation:
             background: "#222222" # same fixed color for dark theme
+            appBarBackgroundScheme: dark
   packages: all
 
 organization:

dynamic-plugins.default.yaml

@@ -0,0 +1,82 @@
+plugins:
+
+  # Group: Global floating action button
+  - package: ./dynamic-plugins/dist/red-hat-developer-hub-backstage-plugin-global-floating-action-button-dynamic
+    disabled: true
+    pluginConfig:
+      dynamicPlugins:
+        frontend:
+          red-hat-developer-hub.backstage-plugin-global-floating-action-button:
+            mountPoints:
+              - mountPoint: application/listener
+                importName: DynamicGlobalFloatingActionButton
+
+  # Group: Scaffolder
+  - package: ./dynamic-plugins/dist/backstage-community-plugin-scaffolder-backend-module-kubernetes-dynamic
+    disabled: false
+
+  # Group: Tech Radar
+  - package: ./dynamic-plugins/dist/backstage-community-plugin-tech-radar-backend-dynamic
+    disabled: true
+    pluginConfig:
+      techRadar:
+        url: ${TECH_RADAR_DATA_URL}
+
+  - package: ./dynamic-plugins/dist/backstage-community-plugin-tech-radar-dynamic
+    disabled: true
+    pluginConfig:
+      dynamicPlugins:
+        frontend:
+          backstage-community.plugin-tech-radar:
+            apiFactories:
+              - importName: TechRadarApi
+            appIcons:
+              - name: techRadar
+                importName: TechRadarIcon
+            dynamicRoutes:
+              - path: /tech-radar
+                importName: TechRadarPage
+                menuItem:
+                  icon: techRadar
+                  text: menuItem.techRadar
+                  textKey: menuItem.techRadar
+                config:
+                  props:
+                    width: 1500
+                    height: 800
+
+  # Group: Github Org
+  - package: ./dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github-org-dynamic
+    disabled: true
+
+  # Group: Kubernetes
+  - package: ./dynamic-plugins/dist/backstage-plugin-kubernetes-dynamic
+    disabled: true
+    pluginConfig:
+      kubernetes:
+        serviceLocatorMethod:
+          type: 'multiTenant'
+        clusterLocatorMethods:
+          - type: 'config'
+            clusters:
+              - name: ${K8S_CLUSTER_NAME}
+                url: ${K8S_CLUSTER_URL}
+                authProvider: 'serviceAccount'
+                skipTLSVerify: true
+                serviceAccountToken: ${K8S_CLUSTER_TOKEN}
+  - package: ./dynamic-plugins/dist/backstage-plugin-kubernetes-dynamic
+    disabled: true
+    pluginConfig:
+      dynamicPlugins:
+        frontend:
+          backstage.plugin-kubernetes:
+            mountPoints:
+              - mountPoint: entity.page.kubernetes/cards
+                importName: EntityKubernetesContent
+                config:
+                  layout:
+                    gridColumn: "1 / -1"
+                  if:
+                    anyOf:
+                      - hasAnnotation: backstage.io/kubernetes-id
+                      - hasAnnotation: backstage.io/kubernetes-namespace