Skip to content

RHDEVDOCS-6206: Builds for OpenShift: Disconnected Install Instructions #85106

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 26, 2024
Merged

RHDEVDOCS-6206: Builds for OpenShift: Disconnected Install Instructions #85106

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions installing/installing-openshift-builds.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,3 +32,5 @@ include::modules/ob-installing-builds-using-cli.adoc[leveloffset=+1]
== Additional resources

* link:https://docs.openshift.com/container-platform/latest/operators/admin/olm-adding-operators-to-cluster.html#olm-adding-operators-to-a-cluster[Adding Operators to a cluster]


26 changes: 26 additions & 0 deletions modules/ob-creating-buildah-build-in-a-network-restricted-environment.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
// Module included in the following assemblies:
//
//* builds/work-with-builds.adoc

:_mod-docs-content-type: PROCEDURE
[id='ob-creating-buildah-build-in-a-network-restricted-environment_{context}']
= Creating buildah build in a network restricted environment
Copy link
Contributor

Choose a reason for hiding this comment

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

Should this be restricted network? I see network restricted environment is used elsewhere in the Builds docs.
If network restricted environment and restricted network are not the same thing, we should at least go with network-restricted environment.
Can be done in a separate PR. Not worth holding up the merge.


You can create a `buildah` build in a network restricted environment by mirroring the images required by the `buildah` build strategy.

.Prerequisites

* Your cluster can connect and interact with the git source that you can use to create the buildah build.
.Procedure

. Run the following command to mirror the images required by the `buildah` build strategy:
+
[source,terminal]
----
$ oc image mirror --insecure -a <registry_authentication> registry.redhat.io/ubi8/buildah@sha256:1c89cc3cab0ac0fc7387c1fe5e63443468219aab6fd531c8dad6d22fd999819e <mirror_registry>/<repo>/ubi8_buildah
----
+
. Perform the steps mentioned in the "Creating a buildah build" section.

26 changes: 26 additions & 0 deletions modules/ob-creating-s2i-build-in-a-network-restricted-environment.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
// Module included in the following assemblies:
//
// * builds/work-with-builds.adoc

:_mod-docs-content-type: PROCEDURE
[id='ob-creating-source-to-image-build-in-a-network-restricted-environment_{context}']
= Creating source-to-image build in a network restricted environment

You can create a `source-to-image` build in a network restricted environment by mirroring the images required by the `source-to-image` build strategy.

.Prerequisites

* Your cluster can connect and interact with the git source that you can use to create the source-to-image build.
* You have the builder-image required to create the `source-to-image` build in your local registry. If you do not have the builder-image in the local registry, mirror the source image.

.Procedure

. Run the following command to mirror the images required by the `source-to-image` build strategy:
+
[source,terminal]
----
$ oc image mirror --insecure -a <registry_authentication> registry.redhat.io/source-to-image/source-to-image-rhel8@sha256:d041c1bbe503d152d0759598f79802e257816d674b342670ef61c6f9e6d401c5 <mirror_registry>/<repo>/source-to-image-source-to-image-rhel8
----
+

. Perform the steps mentioned in the "Creating a source-to-image build" section.
7 changes: 6 additions & 1 deletion work_with_builds/using-builds.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,12 @@ After installing {builds-shortname}, you can create a `buildah` or `source-to-im

include::modules/ob-creating-a-buildah-build.adoc[leveloffset=+1]

include::modules/ob-creating-buildah-build-in-a-network-restricted-environment.adoc[leveloffset=+2]

include::modules/ob-creating-a-s2i-build.adoc[leveloffset=+1]

include::modules/ob-creating-s2i-build-in-a-network-restricted-environment.adoc[leveloffset=+2]

include::modules/ob-viewing-logs.adoc[leveloffset=+1]

include::modules/ob-deleting-a-resource.adoc[leveloffset=+1]
Expand All @@ -25,4 +29,5 @@ include::modules/ob-deleting-a-resource.adoc[leveloffset=+1]
== Additional resources

* xref:../authenticating/understanding-authentication-at-runtime.adoc#ob-authentication-to-container-registries_understanding-authentication-at-runtime[Authentication to container registries]
* xref:../installing/installing-openshift-builds.adoc#creating-a-shipwright-build-resource-console_installing-openshift-builds[Creating a ShipwrightBuild resource by using the web console]
* xref:../installing/installing-openshift-builds.adoc#creating-a-shipwright-build-resource-console_installing-openshift-builds[Creating a ShipwrightBuild resource by using the web console]
* xref:https://docs.openshift.com/container-platform/4.17/disconnected/mirroring/installing-mirroring-installation-images.html[Mirroring images for a disconnected installation by using the oc adm command]