[Bug 2134985] Re: ceph-mgr-dashboard renders blank page due to missing JavaScript files in package 19.2.3

[Matthew Ruffell]

Uploading to questing:

Uploading ceph using ftp to ubuntu:
Uploading ceph_19.2.3-0ubuntu1.25.10.2.dsc
Uploading ceph_19.2.3-0ubuntu1.25.10.2.debian.tar.xz
Uploading ceph_19.2.3-0ubuntu1.25.10.2_source.buildinfo
Uploading ceph_19.2.3-0ubuntu1.25.10.2_source.changes

-- 
You received this bug notification because you are a member of Ubuntu
OpenStack, which is subscribed to ceph in Ubuntu.
https://bugs.launchpad.net/bugs/2134985

Title:
  ceph-mgr-dashboard renders blank page due to missing JavaScript files
  in package 19.2.3

Status in ceph package in Ubuntu:
  In Progress
Status in ceph source package in Noble:
  In Progress
Status in ceph source package in Plucky:
  Won't Fix
Status in ceph source package in Questing:
  In Progress
Status in ceph source package in Resolute:
  In Progress

Bug description:
  [Impact]

  The ceph-mgr-dashboard fails to load the user interface after upgrading the ceph
  package to version 19.2.3-0ubuntu0.24.04.1 on Ubuntu 24.04 LTS.

  Instead of the login screen, the browser renders a completely blank white page.
  The browser console confirms that the server returns 404 Not Found errors for 
  critical JavaScript files required to render the application.

  This is a regression in 19.2.3, where the compiled frontend artifacts 
  (JavaScript bundles) were not correctly included in the final .deb package in 
  /usr/share/ceph/mgr/dashboard/frontend/dist/.

  This is because the JavaScript bundles were added to the d/clean file during the
  19.2.3 release process. We are going to revert that change, back to the d/clean
  file from 19.2.1.

  [Testcase]

  You first need a ceph cluster already deployed and running. We will be talking
  to its mgr service from the reproducer system.

  Once that ceph cluster is deployed and operational:

  $ sudo apt update
  $ sudo apt install ceph cephadm ceph-mgr-dashboard

  Bootstrap a ceph cluster on the VM:

  $ sudo cephadm bootstrap --mon-ip <ceph-cluster-ip> --single-host-
  defaults

  After installation is done, the process will show the credentials needed for the
  dashboard. We can then log into it to make sure it's working.

  $ sudo ceph mgr module enable dashboard

  Then navigate to the dashboard in a webbrowser, and use the credentials from
  the previous command.

  http://<vm-ip>:8080 or http://<vm-ip>:8443

  Expected Result:
  The Ceph Dashboard login page should load successfully.

  Actual Result:
  * The browser displays a blank white page.
  * Browser Console/Network Tab: Requests for .js files (e.g., main.js, 
  runtime.js, or similar chunks) return 404 Not Found.

  Alternatively, you can also just check to see if the files are
  present:

  $ sudo apt install ceph-mgr-dashboard
  $ ls -l /usr/share/ceph/mgr/dashboard/frontend/dist/*/*.js

  There are test packages available in the following ppa:

  https://launchpad.net/~mruffell/+archive/ubuntu/lp2134985-updates

  If you install the test packages, the JavaScript files will be present and the
  dashboard will function as normal.

  [Where problems can occur]

  We are reverting d/clean back to its state in 19.2.1, that is, removing all the
  items added in the 19.2.3 SRU.

  These were added for not-really-convincing reasons, and should just be
  dropped.

  The biggest difference is re-adding the JavaScript files back, so ceph dashboard
  can function again.

  There are other files, namely the btrfs testsuite and ceph QA yaml files. These
  are not used during build and are not present in final packaging, and likely
  will not cause any regressions to end users.

  If a regression were to occur, users could copy back files from previous
  packages, or will likely need to rollback until a fix is ready.

  [Other info]

  Luciano has summed up the uses of the other files in comment #21.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/ceph/+bug/2134985/+subscriptions