diff --git a/10-systems/applications/gitbucket.md b/10-systems/applications/gitbucket.md new file mode 100644 index 0000000..a8ce85d --- /dev/null +++ b/10-systems/applications/gitbucket.md @@ -0,0 +1,151 @@ +--- +owner: gmikcon +status: active +last_reviewed: 2026-05-10 +review_interval: 30d +confidence: high +source_of_truth: gitbucket-api-and-nginx-proxy +--- + +# GitBucket + +GitBucket is the central Git hosting service for the owner's projects. + +## Access + +- Public URL: `https://git.gnexus.space/` +- API base URL: `https://git.gnexus.space/api/v3` +- Repository owner observed: `root` +- Authentication: personal access token, owner-managed. +- Secret values are not stored in this repository. + +## Infrastructure Path + +Public access follows the standard `gnexus.space` route: + +`Internet -> external-vps -> OpenVPN tunnel -> internal-proxy-vps -> internal-nginx-proxy -> gitbucket VM` + +Known routing: + +- Domain: `git.gnexus.space` +- Internal nginx upstream: `http://192.168.1.156` +- VM inventory id: `gitbucket` +- Hypervisor: `hp-proliant-dl380-g6` +- VM resources: 4 vCPU, 8192 MiB RAM. + +## Role + +This service is the source of truth for software projects. Agents should use it to: + +- discover repositories; +- connect deployed services to their source repositories; +- find upstream README/docs/runbooks; +- identify project ownership, public/private status, and default branches. + +Agents should not: + +- store access tokens in docs; +- clone or read secret-bearing files unless explicitly instructed; +- treat every repository as a deployed service; +- infer production ownership without deployment evidence. + +## Repository Snapshot + +Observed through GitBucket API on 2026-05-10. + +Total repositories visible to `root`: 65. + +Activity labels are based only on last commit date: + +- `active-2026`: touched in 2026. +- `dormant-2025`: last touched in 2025; likely inactive unless deployment evidence says otherwise. +- `old-2024`: last touched in 2024; treat as abandoned/archive candidate until confirmed. + +| Repository | Visibility | Branch | Last commit | SHA | Activity | Description | +| --- | --- | --- | --- | --- | --- | --- | +| `navi-1` | private | `master` | 2026-05-09 | `6d21570` | active-2026 | | +| `gnexus-book` | public | `master` | 2026-05-08 | `b70ad67` | active-2026 | | +| `gnexus-ui-kit` | public | `master` | 2026-05-08 | `f7fb261` | active-2026 | | +| `mardis_calc` | public | `master` | 2026-05-06 | `25a01e5` | active-2026 | | +| `gnexus-auth` | private | `master` | 2026-05-05 | `4ce05a5` | active-2026 | | +| `gnexus-auth-client-py` | public | `master` | 2026-05-04 | `9a087f1` | active-2026 | | +| `smart-home-server` | public | `master` | 2026-04-25 | `d81f6d6` | active-2026 | | +| `gnexus-auth-client-php` | public | `main` | 2026-04-24 | `c95c99f` | active-2026 | | +| `lytvak` | private | `master` | 2026-04-18 | `6dea7fc` | active-2026 | | +| `navi-webclient` | private | `master` | 2026-04-15 | `8d0c3e9` | active-2026 | | +| `ubuntu_server_scripts` | public | `master` | 2026-04-01 | `4070c62` | active-2026 | | +| `medialib-manager` | public | `master` | 2026-04-01 | `a58347b` | active-2026 | | +| `exp-cats-new` | public | `master` | 2026-03-31 | `2f1ef31` | active-2026 | | +| `DOCS` | private | `master` | 2026-03-29 | `1b37dbb` | active-2026 | Документация которую можно использовать для применения с помощью ИИ к проекту. | +| `gnexus-welcome-page` | public | `main` | 2026-03-29 | `c7d6ed2` | active-2026 | | +| `todo-ai` | private | `master` | 2025-10-28 | `f102d88` | dormant-2025 | | +| `con2` | private | `master` | 2025-10-10 | `ecb9d38` | dormant-2025 | | +| `fast-kognitest` | public | `master` | 2025-08-04 | `adfd80c` | dormant-2025 | | +| `gate_interface` | private | `master` | 2025-07-18 | `85c2a62` | dormant-2025 | | +| `vmk-demo-bot` | public | `master` | 2025-07-15 | `d57cc60` | dormant-2025 | | +| `mia_bot` | private | `master` | 2025-06-06 | `17060f8` | dormant-2025 | | +| `fix-cyrillic` | public | `master` | 2025-05-26 | `1bb4de2` | dormant-2025 | | +| `duck-search-for-ai` | private | `master` | 2025-04-25 | `27b45d9` | dormant-2025 | | +| `voice-gen` | private | `master` | 2025-04-24 | `4736181` | dormant-2025 | | +| `web-page-scrubber` | private | `master` | 2025-04-22 | `b245058` | dormant-2025 | | +| `whisper` | private | `master` | 2025-04-22 | `8997fff` | dormant-2025 | | +| `simple_task_manager` | public | `master` | 2025-04-20 | `ef67697` | dormant-2025 | | +| `projectX` | private | `master` | 2025-03-14 | `d9c09b0` | dormant-2025 | | +| `say_themes` | private | `master` | 2025-03-12 | `3e44c26` | dormant-2025 | | +| `translater` | private | `master` | 2025-03-03 | `334c79d` | dormant-2025 | | +| `gen-img-from-track` | private | `master` | 2025-02-25 | `ac30772` | dormant-2025 | | +| `radio` | private | `master` | 2025-02-23 | `2c55a0b` | dormant-2025 | | +| `radio-streamer` | private | `master` | 2025-02-23 | `5e6bf48` | dormant-2025 | | +| `playlist-maker` | private | `master` | 2025-02-22 | `4cac173` | dormant-2025 | | +| `scover` | public | `master` | 2025-02-22 | `c7a9768` | dormant-2025 | | +| `vec_search` | private | `master` | 2025-02-20 | `a42ee9b` | dormant-2025 | | +| `yummspace` | public | `master` | 2025-02-17 | `a620963` | dormant-2025 | | +| `nexp1` | private | `master` | 2025-02-13 | `7d75dc0` | dormant-2025 | | +| `tf-idf` | public | `master` | 2025-02-08 | `b040e30` | dormant-2025 | | +| `con` | private | `master` | 2025-02-08 | `9b38239` | dormant-2025 | | +| `vmk-olainfarm-db-backup` | private | `master` | 2025-01-28 | `431dcf5` | dormant-2025 | | +| `clear-wplms-students` | public | `master` | 2025-01-28 | `92d7d0f` | dormant-2025 | | +| `wwwcats` | public | `master` | 2025-01-22 | `4b45804` | dormant-2025 | | +| `ferumina-xml-products` | private | `master` | 2025-01-06 | `d2e1add` | dormant-2025 | | +| `flow-task` | public | `master` | 2024-12-29 | `b97de18` | old-2024 | | +| `disk-space-api` | private | `master` | 2024-12-13 | `ef26e5f` | old-2024 | | +| `taskmanager` | public | `master` | 2024-12-07 | `2f8598d` | old-2024 | | +| `vue-indexer` | public | `master` | 2024-09-24 | `4e69344` | old-2024 | | +| `open-logistic-tycoon` | public | `master` | 2024-07-10 | `bd50659` | old-2024 | | +| `olainfarm` | private | `master` | 2024-07-09 | `9a677cc` | old-2024 | | +| `wppverif` | private | `master` | 2024-06-20 | `d5c2f52` | old-2024 | | +| `wpp-verif` | private | `master` | 2024-06-19 | `30becd1` | old-2024 | | +| `wplms_user_transport` | private | `master` | 2024-06-18 | `3726f81` | old-2024 | | +| `home-web-panel` | private | `master` | 2024-06-06 | `1e68e09` | old-2024 | | +| `music-loader` | public | `master` | 2024-05-23 | `fbbef7d` | old-2024 | | +| `gnexus-blog` | private | `master` | 2024-05-21 | `74f9da5` | old-2024 | | +| `gnexus-scope` | private | `master` | 2024-05-14 | `d994467` | old-2024 | | +| `sshffmpeg` | private | `master` | 2024-05-14 | `0aaa35c` | old-2024 | | +| `music-parser` | private | `master` | 2024-04-25 | `f52a9dd` | old-2024 | For parsing music tracks from chosic.com | +| `anicusi` | public | `master` | 2024-04-11 | `5b04d51` | old-2024 | | +| `upsmon` | private | `master` | 2024-03-23 | `43fed98` | old-2024 | | +| `subnet_status` | private | `main` | 2024-03-17 | `5467f6d` | old-2024 | | +| `vmk_servier` | private | `main` | 2024-02-27 | `342fb05` | old-2024 | | +| `kimai` | private | `main` | 2024-02-13 | `f4896f4` | old-2024 | | +| `store` | private | `master` | 2024-01-30 | `2d30cc9` | old-2024 | | + +## Follow-Up Classification + +Repositories should be promoted from this catalog into detailed project records when one of these is true: + +- the project is deployed on a host or VM; +- the project owns a public domain or internal endpoint; +- the project is an infrastructure tool; +- the project is actively maintained; +- the project has reusable documentation for other agents. + +Useful next groups: + +- Gnexus core: `gnexus-auth`, `gnexus-auth-client-py`, `gnexus-auth-client-php`, `gnexus-ui-kit`, `gnexus-book`. +- Public services: `gnexus-welcome-page`, `lytvak`, `navi-1`, `navi-webclient`, `smart-home-server`. +- AI/search/media tools: `vec_search`, `duck-search-for-ai`, `web-page-scrubber`, `voice-gen`, `whisper`, `music-parser`. +- Home/infrastructure tools: `smart-home-server`, `home-web-panel`, `subnet_status`, `upsmon`, `disk-space-api`, `ubuntu_server_scripts`. + +## Credential Policy + +GitBucket credentials are owner-managed and must not be stored in this repository. If a personal access token is used for documentation work, it should be considered temporary and revoked or rotated after the documentation pass. diff --git a/40-inventory/endpoints.yml b/40-inventory/endpoints.yml index 9dc7b0f..ea2e86f 100644 --- a/40-inventory/endpoints.yml +++ b/40-inventory/endpoints.yml @@ -81,6 +81,43 @@ last_reviewed: 2026-05-09 source_of_truth: curl-observed-and-ssh-nginx +- id: gitbucket-web + name: GitBucket Web UI + type: git-hosting-ui + status: active + exposure: public + url: https://git.gnexus.space/ + protocol: https + host: git.gnexus.space + port: 443 + domain: git-gnexus-space + service: gitbucket + owner_host: gitbucket + purpose: Web UI for GitBucket repositories. + auth: required + docs: ../10-systems/applications/gitbucket.md + last_reviewed: 2026-05-10 + source_of_truth: gitbucket-api-and-nginx-proxy + +- id: gitbucket-api + name: GitBucket API + type: git-hosting-api + status: active + exposure: public + url: https://git.gnexus.space/api/v3 + protocol: https + host: git.gnexus.space + port: 443 + domain: git-gnexus-space + service: gitbucket + owner_host: gitbucket + purpose: GitHub-compatible API for repository metadata and automation. + auth: personal-access-token + credential_reference: owner-managed + docs: ../10-systems/applications/gitbucket.md + last_reviewed: 2026-05-10 + source_of_truth: gitbucket-api + - id: internal-proxy-ssh name: Internal Proxy VPS SSH type: ssh diff --git a/40-inventory/projects.yml b/40-inventory/projects.yml index a57d1f5..a44a292 100644 --- a/40-inventory/projects.yml +++ b/40-inventory/projects.yml @@ -85,3 +85,25 @@ docs: ../10-systems/automations/smart-home-overview.md last_reviewed: 2026-05-10 source_of_truth: ssh-host-and-repository + +- id: gitbucket-repository-catalog + name: GitBucket Repository Catalog + status: active + type: repository-catalog + description: Catalog of repositories visible to the root account on the GitBucket instance at git.gnexus.space. + source_service: gitbucket + repository_count_observed: 65 + repository_owner: root + documentation: + - label: GitBucket overview and repository catalog + path: ../10-systems/applications/gitbucket.md + role: repository-catalog + related_services: + - gitbucket + related_hosts: + - gitbucket + related_domains: + - git-gnexus-space + docs: ../10-systems/applications/gitbucket.md + last_reviewed: 2026-05-10 + source_of_truth: gitbucket-api diff --git a/40-inventory/services.yml b/40-inventory/services.yml index d26423f..7623898 100644 --- a/40-inventory/services.yml +++ b/40-inventory/services.yml @@ -140,3 +140,27 @@ runbook: "" last_reviewed: 2026-05-10 source_of_truth: owner-described-and-ssh-host + +- id: gitbucket + name: GitBucket + type: git-hosting + status: active + host: gitbucket + domains: + - git-gnexus-space + ports: + - 80 + criticality: high + public_url: https://git.gnexus.space/ + internal_upstream: http://192.168.1.156 + repository_owner: root + repository_count_observed: 65 + api: + base_url: https://git.gnexus.space/api/v3 + compatibility: GitHub-compatible API surface + auth: personal-access-token + credential_reference: owner-managed + docs: ../10-systems/applications/gitbucket.md + runbook: "" + last_reviewed: 2026-05-10 + source_of_truth: gitbucket-api-and-nginx-proxy diff --git a/40-inventory/virtual-machines.yml b/40-inventory/virtual-machines.yml index e4e61ee..a92a18e 100644 --- a/40-inventory/virtual-machines.yml +++ b/40-inventory/virtual-machines.yml @@ -28,11 +28,13 @@ vcpus: 4 memory_mib: 8192 autostart: true - addresses: [] - runs_services: [] + addresses: + - 192.168.1.156 + runs_services: + - gitbucket docs: ../10-systems/virtualization/libvirt-vms.md - last_reviewed: 2026-05-09 - source_of_truth: ssh-libvirt + last_reviewed: 2026-05-10 + source_of_truth: ssh-libvirt-and-gitbucket-api - id: alex name: alex