suggestion on installation of starlingx

[[e-mail]]

Hi,

I am new to starlingx and trying to install on virtual or baremetal environment.
And I found it hard for users in China Mainland to install directly via ansible-playbook due to network issues.
Is it possible to make an ater option that we can download all docker images from somewhere and use docker load in ansible so we don't have network issue on deployment.

Another problem for us is, it's too slow to get images/packages download from starlingx mirror site.
Will you provide rsync so others can make repo?
eg: I can rsync all resources from aws then download by scp/http.
Then I mannully edit ansible yaml file, replace it with my own bash script:

sudo vim /usr/share/ansible/stx-ansible/playbooks/roles/common/push-docker-images/tasks/main.yml
142 - name: Download images and push to local registry
143 # script: download_images.py {{ download_images }}
144 shell: cd /opt ; bash ./load_docker.sh
145 register: download_images_output
146 environment:
147 REGISTRIES: "{{ registries | to_json }}"

After unlock controller-0, when applying stx-openstack, I found some process still working on docker pull images.
That's also very very slow for us.

This bug tracker is for errors with the documentation, use the following as a template and remove or add fields as you see fit. Convert [ ] into [x] to check boxes:

- [ ] This doc is inaccurate in this way: ______
- [ ] This is a doc addition request.
- [x] I have a fix to the document that I can paste below including example: input and output.

If you have a troubleshooting or support issue, use the following resources:

 - Ask OpenStack: https://ask.openstack.org
 - The mailing list: https://lists.openstack.org
 - IRC: 'openstack' channel on Freenode

-----------------------------------
Release: 4.0.0.0rc1.dev10 on 2019-12-05 16:10:49
SHA: cb2121099ffe0338d28c9f781b185e9a794a035c
Source: https://opendev.org/openstack/stx-docs/src/doc/source/deploy_install_guides/r3_release/virtual/aio_simplex.rst
URL: https://docs.starlingx.io/deploy_install_guides/r3_release/virtual/aio_simplex.html

[Bruno Drugowick Muniz (brunomuniz)]

I have a WIP Review that might be related to this. I'm still testing because some of my teammates found problems using it and we're still to determine if it's a setup issue on their side or something that I forgot to add to the guide.

You still would have to download the images from the internet at least once, but the script that does this can be restarted anytime and will always pick up from where it stopped. Once that's done, you can override the registries for the bootstrap (there're instructions in the guide for that as well).

Have in mind that it still needs reviews from the community, but I was able to use it already a couple of times. And if we agree this fixes this bug I can amend the Review to close/fix this bug.

Here's the guide mentioned: https://review.opendev.org/c/starlingx/docs/+/884643

[Bruno Drugowick Muniz (brunomuniz)]

Haven't heard from OP. What's the assignee doing exactly? Can I help somehow?

Am I making sense when I say that a local external docker registry with a helper script to populate it might solve the problem? Or are we considering other alternatives like mirroring on a better location for the APAC region?

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/c/starlingx/docs/+/884643
Committed: https://opendev.org/starlingx/docs/commit/1fc795a68f166607dfd7f75d4c74eebea8756b1f
Submitter: "Zuul (22348)"
Branch: master

commit 1fc795a68f166607dfd7f75d4c74eebea8756b1f
Author: Bruno Muniz <email address hidden>
Date: Mon May 29 17:23:16 2023 -0300

    Add a local registry guide for developers

    The guide is aimed at developers working in virtual environments that
    need to build or run several controller-0 setups (specifically, to
    developers in need of running the Ansible bootstrap playbook multiple
    times).

    By configuring a local registry and downloading the needed images
    beforehand, all subsequent installations can point to this local
    registry to download images from it to the controller-0. Not going to
    the internet everytime, devs are not subject to public registries' rate
    limits.

    Story: 2005051
    Task: 47895
    Partial-Bug: 1834504
    Partial-Bug: 1888610

    Change-Id: Ie3e3cbc09030a6491f7b573a4ea5fd57e3158d54
    Signed-off-by: Bruno Muniz <email address hidden>

[Bruno Drugowick Muniz (brunomuniz)]

Would this help, OP? https://docs.starlingx.io/developer_resources/local_registry.html

[Ghada Khalil (gkhalil)]

Doc updates were made in the stx.9.0 release timeframe; adding the release tag.