{"id":18369953,"url":"https://github.com/decko-commons/decko-ubos","last_synced_at":"2025-04-10T19:44:42.839Z","repository":{"id":31943375,"uuid":"112903141","full_name":"decko-commons/decko-ubos","owner":"decko-commons","description":"Decko for UBOS","archived":false,"fork":false,"pushed_at":"2024-04-21T00:54:31.000Z","size":185,"stargazers_count":0,"open_issues_count":14,"forks_count":1,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-02-15T20:57:07.904Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/decko-commons.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-03T05:35:57.000Z","updated_at":"2024-04-21T00:54:35.000Z","dependencies_parsed_at":"2023-11-17T23:56:12.360Z","dependency_job_id":"6c883ad0-acd7-4916-bd83-e201494a3bcd","html_url":"https://github.com/decko-commons/decko-ubos","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decko-commons%2Fdecko-ubos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decko-commons%2Fdecko-ubos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decko-commons%2Fdecko-ubos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decko-commons%2Fdecko-ubos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/decko-commons","download_url":"https://codeload.github.com/decko-commons/decko-ubos/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248281425,"owners_count":21077423,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T23:34:33.355Z","updated_at":"2025-04-10T19:44:42.802Z","avatar_url":"https://github.com/decko-commons.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"# decko-ubos\n\nPackaging Decko tool for UBOS.\n\n# Setup Docker dev environment\n\n1. Make sure you have docker (and docker compose) installed and then run the following from the root of this repo.\n\n```\ndocker compose up -d\n```\n\nMay have to wait for services to start...\n\n2. Open shell.\n\n```   \ndocker exec -i -t -u ubosdev ubos-develop bash\n```\n\n3. Get the latest ubos-admin and install dependencies from INSIDE the container\n```\nsudo ubos-admin update -v --nokeyrefresh\nsudo pacman -S --noconfirm base-devel pacman-contrib webapptest\n```\n\n# Update to latest Decko version\n\n1. Start by updating gems (including decko) from OUTSIDE the container\n\n```\n# from decko-ubos root\ncd decko\nbundle update\nbundle info decko # confirm version. may need to tweak Gemfile to get it to work\n```\n\n2. Meanwhile, edit PKGBUILD.\n\n- update decko version in PKGBUILD\n- reset pkgrel to 1 if it has been changed\n\n3. Run the following INSIDE the container in the home dir:\n\n```\nupdpkgsums   # update checksum in PKGBUILD\n```\n\n# Make and Install your decko package\n\nRun the following INSIDE the container in the home dir:\n\n```\nmakepkg -f -s                             # generate a new package\nsudo pacman -U decko-*-any.pkg.tar.zst    # install a package you've generated\n```\n\n\n# Deploy a Deck\n\nRun the following INSIDE the container:\n\n```\n\n# sudo ubos-admin undeploy --all                # often handy\nsudo ubos-admin deploy --file sample-site.json  # deploy the site\n```\n\nOnce deployed, the site should be reachable at http://localhost:8080/deck\n\n\n# Restore a Deck from backups\n\n```\n# sudo ubos-admin undeploy --all                                    # often handy\nsudo ubos-admin backupinfo --detail --in backups/BACKUP.ubos-backup # gives siteid\nsudo ubos-admin restore --newhostname '*' --in backups/BACKUPNAME.ubos-backup  --siteid SITEIDFROMINFO\n```\n\nOnce restored, the site should be reachable at http://localhost:8080  (unless the \nbackup specifies a different context)\n\n\n# Run Test\n\n```\nwebapptest run tests/DeckoTest.pm\n\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecko-commons%2Fdecko-ubos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdecko-commons%2Fdecko-ubos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecko-commons%2Fdecko-ubos/lists"}