Skip to content

Update the "Use soyuz" locally and "develop with buildd" docs.#464

Open
tushar5526 wants to merge 8 commits into
mainfrom
build-package-locally
Open

Update the "Use soyuz" locally and "develop with buildd" docs.#464
tushar5526 wants to merge 8 commits into
mainfrom
build-package-locally

Conversation

@tushar5526

Copy link
Copy Markdown
Member
  • I ran make linkcheck-discrete locally to confirm new or edited links
    will pass the linkcheck CI.

Comment thread docs/developer/how-to/develop-with-buildd.rst
Comment thread docs/developer/how-to/develop-with-buildd.rst Outdated
Comment thread docs/developer/how-to/develop-with-buildd.rst Outdated
Launchpad Buildd
----------------
Set up Launchpad Buildd
~~~~~~~~~~~~~~~~~~~~~~~

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is important to clarify which of the sections/steps need to run inside the VM or on the host.

Install dependencies
--------------------

Add the staging Buildd and Launchpad PPA.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we create a script like the rocketfuel-setup script (not the best example, I know) that handles these automatically?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, but I will do that as a separate task if a lot of people start using this manual process to setup local builds.


.. code-block:: sh

$ utilities/soyuz-sampledata-setup.py -e you@example.com

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Speaking of which, we need to update the sampledata setup script to include some of the recent releases.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this script gets updated as part of releasing a new ubuntu version because I was able to find relatively new series in the local DB after I ran it.

* ``LP_DISABLE_SSL_CERTIFICATE_VALIDATION=1 manage-chroot -l dev -s precise -a i386 -f chroot-ubuntu-precise-i386.tar.bz2 set``
* Register a new builder with the URL pointed to ``http://YOUR-BUILDER-IP:8221/`` (https://launchpad.test/builders/+new)
git_browse_root = http://git.launchpad.test:9419/
git_ssh_root = git+ssh://git.launchpad.test:9422/

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it is worth mentioning here that the turnip container must be set up and running the services, and that an entry for git.launchpad.test should be added for this to work.

On a related note, we should update the turnip development environment setup to make git access using the default ports work correctly via haproxy.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't need turnip for dput atleast. I will add a note.


Change https://launchpad.test/ubuntu/+pubconf as admin from ``http://archive.launchpad.test`` to ``http://archive.ubuntu.com``.

In ``launchpad/launchpad/configs/development/launchpad-lazr.conf``, set the following configuration to point builders to your local environment:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It might not be a bad idea to create a new configuration top-level directory for this and pre-populate all the relevant values and secrets there so that we do not need to set that up manually. Launchpad and its services need to be started with LPCONFIG=new-configuration-name <command to run processes>.

Comment thread docs/developer/how-to/use-soyuz-locally.rst Outdated
Comment thread docs/.custom_wordlist.txt
proxied
psql
pstats
publishings

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This needs to be removed after addressing a suggestion for this word above. It is not a proper English word.

Comment thread docs/developer/how-to/develop-with-buildd.rst

You may have to calculate a new ``sha1sum`` of the ``chroot`` file.

Upload a source to the PPA

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This and the other two sections should be in separate tabs since they're different applications that not each user would need to follow concurrently


4. After 30 seconds or so, the status of the builder on the builders page should be 'Idle'. This page does not auto-update, so refresh!

Running a build on qastaging

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move this to a new doc. It has nothing to do with the rest of the doc.

Comment thread docs/developer/how-to/develop-with-buildd.rst Outdated
tushar5526 and others added 5 commits March 24, 2026 17:17
Co-authored-by: Guruprasad <lgp171188@users.noreply.github.com>
Co-authored-by: Guruprasad <lgp171188@users.noreply.github.com>
Co-authored-by: Guruprasad <lgp171188@users.noreply.github.com>
Fix indentation and remove empty description line.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants