Commit Graph

29 Commits

Author SHA1 Message Date
Nalin Dahyabhai 34a7ce99b1 Update to keep up with API changes in storage
* Call storage.DefaultStoreOptions() instead of
  storage.DefaultStoreOptionsAutoDetectUID() in the tutorial.
* Mention installing passt when installing build-time dependencies.
* Include the registry part of examples that use node:12-alpine.
* Use registry.fedoraproject.org for Fedora images.
* Mention Fedora 40 instead of 35 in examples.
* Mount an emptyDir volume in the OpenShift example, so that it can use
  overlay for storage
* Use a more recent buildah image as the base in the OpenShift example.
* Use a ReplicationController instead of a DeploymentConfig in the
  OpenShift example, because DeploymentConfigs are deprecated.

Signed-off-by: Nalin Dahyabhai <nalin@redhat.com>
2024-08-05 14:56:38 -04:00
Steffen Straub 0ed9b4c8cd Fix tutorial for rootless mode
Before executing `buildah unshare` for mounting a container from scratch
as a non-root user, we need to export the variable `newcontainer` so
that it is known inside the modified user namespace.

Signed-off-by: Steffen Straub <22006250+Steffen1989@users.noreply.github.com>
2023-03-01 18:03:15 +01:00
Maximilien McDermott 2c366d1e54 Simple README fix
Signed-off-by: MaximUltimatum <mcder018@live.com>
2021-11-29 09:24:33 -06:00
Nalin Dahyabhai 40317d6237 docs/tutorials: update
Update tutorials to not expect `buildah run` to do anything if it isn't
given a command to run.  In some cases (including when we need to listen
for incoming connections when we might well not be root) this means we
use `podman run` instead.

Try to avoid using the terms container and image as though they're
interchangeable, which just creates confusion.

Signed-off-by: Nalin Dahyabhai <nalin@redhat.com>
2021-11-15 14:35:55 -05:00
Daniel J Walsh e1dd52ef44
Fix tutorial to specify command on buildah run line
Fixes: https://github.com/containers/buildah/issues/3564

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2021-11-04 03:59:41 -07:00
Kirill Shirinkin 2d822034f8 Rename bud to build, while keeping an alias for to bud.
Signed-off-by: Kirill Shirinkin <kirill@hey.com>
2021-08-25 17:56:58 +02:00
Daniel J Walsh cfe911a3f0
Change references from master to main
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2021-06-23 11:03:24 -04:00
Daniel J Walsh 7775e0f751
Fix tutorial for rootless mode
Users have gotten confused when attempting the introduction turturial in
rootless mode.  Explain that they have to `buildah unshare` before
mounting the image.

Fixes: https://github.com/containers/buildah/issues/2833

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2021-02-10 18:30:15 -05:00
Josh Soref c7963db369 Spelling
Signed-off-by: Josh Soref <jsoref@users.noreply.github.com>
2020-12-21 16:47:18 -05:00
TomSweeneyRedHat 3ef2c57f3c Update Buildah Tutorial to address BZ1867426
A bugzilla was created due to a misunderstaning gleened from the
Buildah tutorial.  The person runing the tutorial followed it exactly,
but the example blew up on RHEL for them.  The reason being is the
`--releasever` option has to use a valid version for the host's OS
when it's working on a scratch container or dnf will fail.

This adds clarifiction to the document to make that clear.

https://bugzilla.redhat.com/show_bug.cgi?id=1867426

Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>
2020-09-09 19:07:15 -04:00
Daniel J Walsh a3f9c3c652
switch containers/libpod to containers/podman
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2020-07-13 17:21:55 -04:00
Daniel J Walsh cd88667465 Ran buildah through codespell
Thanks to Dmitry Smirnov @onlyjob for suggesting this tool.

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>

Closes: #1985
Approved by: TomSweeneyRedHat
2019-11-20 17:38:41 +00:00
TomSweeneyRedHat 6e4f7aa3ce Add clarification to the Tutorial for new users
This is a partial fix for #1895.  This focuses on (hopefully) helping a
user get into Buildah faster when they first hit the buildah.io site and
click down through the tutorials button.  It also clarifies what's currently
out of scope for Buildah, adds some titles to make links easier and a bit more.

I expect I'll either be adding to this or creating a follow on PR to address more
of the notes in #1895.

Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>
2019-10-19 15:39:51 -04:00
Sascha Grunert b288b7a3d9 Update shebangs to take env into consideration
Some operating systems don’t have `bash` in `/bin`, so we should take the
`$PATH` into consideration for searching it.

Signed-off-by: Sascha Grunert <sgrunert@suse.com>

Closes: #1804
Approved by: TomSweeneyRedHat
2019-08-20 11:26:57 +00:00
Adler Medrado 9fa582f3b1 Fix typo
Patch originally proposed by @adlermedrado but never signed.

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>

Closes: #1697
Approved by: ashley-cui
2019-06-28 23:18:29 +00:00
basilrabi 7016ce6418 fix tutorial instructions
Before, there is no $newcontainer image committed thus
`podman run $newcontainer` attempts to pull $newcontainer from the various
container registries.

Signed-off-by: basilrabi <ericbasil.rabi@gmail.com>

Closes: #1627
Approved by: TomSweeneyRedHat
2019-06-01 17:00:24 +00:00
TomSweeneyRedHat 2156c5ac3b Touch up intro
Quick touch up of the intro tutorial to bump releasever and change
diff to merged in mount output

Fixes: #1468

Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>

Closes: #1479
Approved by: rhatdan
2019-04-04 11:54:41 +00:00
Douglas Schilling Landgraf 5f49ad298c docs: 01-intro.md: add missing . in Dockerfile examples
The . is required, otherwise user will get syntax error.

Signed-off-by: Douglas Schilling Landgraf <dougsland@redhat.com>
2019-03-20 13:18:34 -04:00
Eric Stroczynski 43f8bb3c5f docs/tutorials/01-intro.md: enhanced installation instructions
Enhanced installation instructions with links to necessary documentation.

Signed-off-by: Eric Stroczynski <ericstroczynski@gmail.com>

Closes: #1060
Approved by: rhatdan
2018-10-05 18:45:16 +00:00
Nalin Dahyabhai 7681e8dd5b Get rid of dangling whitespace in markdown files
Get rid of dangling whitespace in markdown files, and add a quick
validation check to error out if we try to add any new ones.

Signed-off-by: Nalin Dahyabhai <nalin@redhat.com>
2018-09-18 17:10:13 -04:00
Daniel J Walsh ba012ddec6
Move buildah from projecatatomic/buildah to containers/buildah
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2018-09-18 08:06:11 -04:00
Daniel J Walsh 7ea05189e2 Change references to cri-o to point at new repository
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>

Closes: #993
Approved by: TomSweeneyRedHat
2018-09-09 15:19:59 +00:00
Daniel J Walsh e8c123cc03 Change references to projectatomic/libpod to containers/libpod
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>

Closes: #928
Approved by: umohnani8
2018-08-15 20:13:50 +00:00
KyleRConway 39d0582204 Update 01-intro.md
Adding command to explicitly become root user. I was trying to run commands with "sudo" in front and thus had issues following guide (new user) and this would have helped! Thanks!

Signed-off-by: Kyle R. Conway <kyconway@tower.Home>

Closes: #763
Approved by: rhatdan
2018-06-08 08:31:08 +00:00
TomSweeneyRedHat 3e1f4aeb98 Touchup tutorial for run changes
Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>

Closes: #734
Approved by: rhatdan
2018-05-30 13:48:15 +00:00
TomSweeneyRedHat f4151372e5 Create Tutorials menu and add link to README.md
Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>

Closes: #367
Approved by: rhatdan
2017-12-15 21:28:32 +00:00
William Henry dbea38b440 Add root prompt and some other minor changes
Signed-off-by: William Henry <whenry@redhat.com>
2017-11-02 10:30:11 -06:00
William Henry 0bc120edda Made some edits based on tsweeney feedback.
Signed-off-by: William Henry <whenry@redhat.com>
2017-11-02 10:13:30 -06:00
William Henry 79663fe1a0 Added file tutorials/01-intro.md
A basic introduction to buildah tutorial

Topics covered:
buildah from a base
briefly describes containers/storage and containers/image
buildah run
buildah from scratch
installing packages and files to a scratch image
buildah push and running a buildah built container in docker
buildah bud

Signed-off-by: William Henry <whenry@redhat.com>

Closes: #302
Approved by: rhatdan
2017-10-31 13:06:51 +00:00