Skip to content

Commit 0ad157c

Browse files
committed
Minor edits to remote builds via the Singularity CLI section ... including a screenshot ...
1 parent d50ddb8 commit 0ad157c

File tree

2 files changed

+10
-4
lines changed

2 files changed

+10
-4
lines changed

lolcow_sylabsrb.png

22.6 KB
Loading

singularity_and_docker.rst

+10-4
Original file line numberDiff line numberDiff line change
@@ -468,7 +468,7 @@ SIF containers can be **remotely built**, from images remotely hosted at the Doc
468468

469469
Once you have an account for Sylabs Cloud, and have logged in to the portal, select `Remote Builder <https://cloud.sylabs.io/builder>`_. The right-hand side of this page is devoted to use of the Singularity CLI. Self-generated API tokens are used to enable authenticated access to the Remote Builder. To create a 30-day token, follow the `instructions provided <https://cloud.sylabs.io/auth/tokens>`_. Once the token has been created, store it in the file ``$HOME/.singularity/sylabs-token``.
470470

471-
The above token provides authenticate use of the Sylabs Cloud Remote Builder when ``--remote`` is appended to the Singularity ``build`` command. For example, for remotely hosted images:
471+
The above token provides authenticated use of the Sylabs Cloud Remote Builder when ``--remote`` is appended to the Singularity ``build`` command. For example, for remotely hosted images:
472472

473473
.. code-block:: none
474474
@@ -498,9 +498,9 @@ The above token provides authenticate use of the Sylabs Cloud Remote Builder whe
498498
INFO: Setting tag latest
499499
87.94 MiB / 87.94 MiB [===============================================================================] 100.00% 17.23 MiB/s 5s
500500
501-
During the build process, progress can be monitored in the Sylabs Cloud portal on the Remote Builder page. Once complete, this results in a local copy of the SIF file ``lolcow_rb.sif``.
501+
During the build process, progress can be monitored in the Sylabs Cloud portal on the Remote Builder page - as illustrated upon completion by the screenshot below. Once complete, this results in a *local* copy of the SIF file ``lolcow_rb.sif``. From the `Sylabs Cloud Singularity Library <https://cloud.sylabs.io/library>`_ it is evident that the 'original' SIF file remains available via this portal.
502502

503-
From the `Sylabs Cloud Singularity Library <https://cloud.sylabs.io/library>`_ it is evident that the 'original' SIF file remains available via this portal.
503+
.. image:: lolcow_sylabsrb.png
504504

505505

506506
.. _sec:mandatory_headers_docker_locally_boostrapped_cli:
@@ -557,6 +557,8 @@ results in ``lolcow_from_docker_cache.sif`` for native use by Singularity. There
557557

558558
The Sylabs Cloud Remote Builder *does not* interoperate with local Docker daemons; therefore, images cached locally by Docker, *cannot* be used to bootstrap creation of SIF files via the Remote Builder service.
559559

560+
Of course, a SIF file could be created locally as detailed above. Then, in a separate, manual step, uploaded to the Sylabs Cloud Singularity Library.
561+
560562

561563

562564
Working with Definition Files
@@ -584,7 +586,9 @@ then
584586
585587
creates a Singularity container in SIF by bootstrapping from the public ``godlovedc/lolcow`` image from the Docker Hub.
586588

587-
In the above definition file, ``docker`` is one of numerous, possible bootstrap agents; this, and other bootstrap agents receive attention :ref:`in the appendix <build-docker-module>`.
589+
In the above definition file, ``docker`` is one of numerous, possible bootstrap agents; this, and other bootstrap agents receive attention :ref:`in the appendix <build-docker-module>`.
590+
591+
.. TODO remote builder content
588592
589593
Through the means for authentication described above, definition files permit use of private images hosted via the Docker Hub. For example, if the file ``mylolcow.def`` has contents
590594

@@ -660,6 +664,8 @@ Then,
660664
661665
In other words, this is the definition-file counterpart to :ref:`the command-line invocation provided above <sec:mandatory_headers_docker_locally_boostrapped_cli>`.
662666

667+
.. TODO remote builder content note - exclusion
668+
663669
664670
Optional Headers
665671
----------------

0 commit comments

Comments
 (0)