Skip to content

Commit

Permalink
Added registration.
Browse files Browse the repository at this point in the history
  • Loading branch information
lvicoun committed Mar 28, 2023
1 parent 22abf16 commit 72c95fc
Showing 1 changed file with 18 additions and 5 deletions.
23 changes: 18 additions & 5 deletions xml/concept-micro-cloud.xml
Original file line number Diff line number Diff line change
Expand Up @@ -24,15 +24,18 @@
<section xml:id="micro-cloud-introduction">
<title>Introduction</title>
<para>
This article provides details specific to &productnameshort; images that are intended for deployment in public cloud environment. Generic information about Public Cloud images are provided in the <link xlink:href="https://documentation.suse.com/sle-public-cloud/all/html/public-cloud/public-cloud.html">Public Cloud Guide</link>.
This article provides details specific to &productnameshort; images that are intended for deployment in public cloud environment. Generic information about Public Cloud images are provided in the <link xlink:href="https://documentation.suse.com/sle-public-cloud/all/html/public-cloud/public-cloud.html">Public Cloud Guide</link>. For other &productnameshort; documentation, refer to the <link xlink:href="https://documentation.suse.com/sle-micro/">&productname; documentation set</link>.
</para>
</section>


<section xml:id="micro-cloud-tools-deployment">
<title>Tools involved in initializing &productnameshort; in public clouds</title>
<para>
The instance intialization is performed using &ignition; and Afterburn. In the default &ignition; configuration, &ignition; is responsible for creating the default user: <literal>suse</literal>. Afterburn passes the SSH key to the user's home directory using the instance metadata service (IMDS).
The instance intialization is performed using &ignition; and Afterburn. In the default &ignition; configuration, &ignition; is responsible for creating the default user: <literal>suse</literal>. &ignition; interacts with the Cloud provider instance metadata service only to get so called user data. Other data, like the user specified in Azure or SSH key from the GCE, are not parsed from this metadata service
</para>
<para>
Afterburn passes the SSH key to the <literal>suse</literal> home directory using the instance metadata service (IMDS). To transfer the SSH key from the IMDS, the <literal>afterburn-sshkeys@suse</literal> is used. The service is started automatically by &systemd;.
</para>
<para>
&ignition; runs on the first boot only. To distinquish the first boot from succeding boots, the flag file <filename>/boot/writable/firstboot_happened</filename> is created. Whenever you want to trigger &ignition; again, you need to remove this file.
Expand Down Expand Up @@ -61,7 +64,7 @@
As with each run of the &tr-up; command a new snapshot is created, keep in mind that these snapshots also take some size, even though, btrfs snapshots are space efficient.
</para>
<para>
The root volume automatically grows as you change the size of the underlying disk. When you are running low on disk space you can always stop your instance and make the system disk bigger, up to the limitation of individual disk sizes in each Cloud framework.
The root volume automatically grows as you change the size of the underlying disk. When you are running low on disk space, you can always stop your instance and make the system disk bigger, up to the limitation of individual disk sizes in each Cloud framework.
</para>
</section>

Expand All @@ -73,13 +76,23 @@
</para>
</section>

<section xml:id="micro-cloud-registration">
<title>Registration</title>
<para>
After you deploy the image, you need to register the system. In newer images, you can use the <command>registercloudguest</command> command to register the system. For details, refer to the <link xlink:href="https://documentation.suse.com/sle-public-cloud/all/html/public-cloud/cha-admin.html#sec-admin-register">public cloud guide</link>.
</para>
<para>
Alternatively, you can register your system as described in the<link xlink:href="https://documentation.suse.com/sle-micro/5.3/html/SLE-Micro-all/cha-postintall-registration.html#sec-images-registration">&productnameshort; registration</link>.
</para>
</section>

<section xml:id="micro-cloud-default-users">
<title>Users of &productnameshort;</title>
<title>Default users of &productnameshort;</title>
<para>
&productnameshort; images comes with a predefined user <literal>suse</literal> that has <command>sudo</command> privileges assigned. Therefore, you can swith to the &rootuser; using the <command>sudo -i</command> command.
</para>
<para>
As the default user probably won't suit your needs, you have several options how to add users according to your needs. Either you can define users in the &ignition; configuration file or you can use the <command>useradd</command> command to add users to the running system.
As the default user probably won't suit your needs, you have several options how to add users. Either you can define users in the &ignition; configuration file or you can use the <command>useradd</command> command to add users to the running system.
</para>
<para>
For details regarding adding users via &ignition;, refer to <link xlink:href="https://documentation.suse.com/sle-micro/html/SLE-Micro-all/cha-images-ignition.html#sec-ignition-examples"></link> and <xref linkend="modifying-ignition-cnfiguration-cloud"/>. For details regarding using the <command>useradd</command> command, see <xref linkend="task-slemicro-useradd"/>.
Expand Down

0 comments on commit 72c95fc

Please sign in to comment.