bringyourownideas / silverstripe-maintenance

Helps with the day by day work to run a SilverStripe application or website.
https://bringyourownideas.com
BSD 3-Clause "New" or "Revised" License
31 stars 10 forks source link
composer maintenance silverstripe silverstripe-maintenance

Silverstripe Maintenance

CI Silverstripe supported module

Overview

The Silverstripe Maintenance module reduces your maintenance related work.

UI Preview

Requirements

Suggested Modules

By default, the module will read your installed modules, and present them as a report in the CMS under admin/reports.

In order to get information about potential updates to these modules, we recommend the installation of the following additional module:

The previously recommended silverstripe-composer-security-checker module can't work anymore and isn't recommended to be used anymore.

Installation

Option 1 (recommended): Install the maintenance package and suggested dependency

composer require bringyourownideas/silverstripe-maintenance bringyourownideas/silverstripe-composer-update-checker

Option 2 (minimal): Install only the maintenance package without any update checks

composer require bringyourownideas/silverstripe-maintenance

Build schema and queue an initial job to populate the database:

sake dev/build

If you haven't already, you need to configure the job queue to update module metadata in the background. By default, this happens every day, but can be configured to run at different intervals through YAML config:

BringYourOwnIdeas\Maintenance\Jobs\CheckForUpdatesJob:
  reschedule_delay: '+1 hour'

Manually running tasks

By default, tasks are run through a job queue. You can also choose to manually refresh via the command line.

Run the update task (includes the update-checker)

sake dev/tasks/UpdatePackageInfoTask

How your composer.json influences the report

The report available through the CMS shows "Available" and "Latest" versions (see user guide). The version recommendations in those columns depend on your composer.json configuration. When setting tight constraints (e.g. silverstripe/framework:4.3.2@stable), newer releases don't show up as expected. We recommend to have looser constraints by default (e.g. silverstripe/framework:^4.3). When the "Latest" version shows dev-master, it likely means that you have "minimum-stability": "dev" in your composer.json.

Documentation

Please see the user guide section.

Contributing

Contributions are welcome! Create an issue, explaining a bug or propose development ideas. Find more information on contributing in the Silverstripe developer documentation.

Reporting Issues

Please create an issue for any bugs you've found, or features you're missing.