document how to publish a PSA for use by the autoupdate tool

Created on 22 October 2019, over 5 years ago
Updated 1 April 2025, 9 days ago

This needs to happen related to #3068539: Add psa.json API endpoint to support automatic updates and #3045273: Add real endpoint after drupal.org provides a live feed .

The basics as I understand them is someone with production drush access has a command to run after a highly-critical PSA comes out, and another after the SA comes out and releases are all published & settled. It is an explicit list of nids, so we also should think about clearing out the data after some amount of time, to make room for the next one, and remove any “remember the current nids and persist them yourself” step.

Draft

When to publish

  • When a PSA announcing an upcoming highly critical core release is published, publish only that PSA. Wait a few minutes in case there are last-minute changes after publishing.
  • When a SA for a highly critical core release is published, publish only that SA.
  • maybe - When a PSA adds widely-useful information after a highly critical core release, publish that PSA along with the SA. It only updates when someone updates it, changes to a PSA or SA node do not trigger an update.
  • Whenever new core security releases are published, the criticality changes, or any any other substantive updates to the API data.
  • maybe, how much time? - Some time after the SA fixes the issue, clear all PSAs and SAs.

How to publish

Anyone with root on production, mlhess, all Association engineering staff, and nnewton have access to update this API.

btch1:~$ sudo -u bender -H drush -r /var/www/drupal.org/htdocs -v drupalorg-update-psa-json --test nid,nid

--test will update https://updates.drupal.org/psa-this-is-only-a-test.json. Omit the option to update the production API at https://updates.drupal.org/psa.json

nid,nid is a comma separated list of PSA and SA nids to include information from. Omit the option to clear all PSAs and SAs.

📌 Task
Status

Fixed

Version

1.0

Component

Documentation

Created by

🇺🇸United States greggles Denver, Colorado, USA

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

  • 🇺🇸United States greggles Denver, Colorado, USA

    I think we've documented this and haven't had to use it as far as I remember.

    It seems this is likely out of date now. I'm not sure if anything similar is still needed. If so, hoping someone following this can help explain.

Production build 0.71.5 2024