Commit Graph

57 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
Kir Kolyshkin bd32a04c37 Remove device mapper support
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
2023-06-12 12:43:16 -07: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
Nalin Dahyabhai 0b7a7f80bb docs/tutorials/04: add defaults for Run()
In the tutorial, switch to calling `DefaultStoreOptionsAutoDetectUID()`
instead of `DefaultStoreOptions()`, which should figure things out
better.

In the tutorial, add an example of using Run(), where for API backward
compatibility reasons, we can't tell the difference between "grant no
capabilties by default" and "grant the default set of capabilities by
default".

The default isolation can be set automatically, so start doing that at
run-time, but have the tutorial look it up anyway because the tutorial
on the web will be newer than our current release for at least a while.

Signed-off-by: Nalin Dahyabhai <nalin@redhat.com>
2023-02-21 08:59:43 -05:00
tomsweeneyredhat f9ef51cbb1 [CI:DOCS] Fix two diversity issues in a tutorial
Touch up a couple of diversity issues in one of the tutorials.

Changes the word "master" to "primary".

[NO NEW TESTS NEEDED]

Signed-off-by: tomsweeneyredhat <tsweeney@redhat.com>
2023-01-20 17:32:47 -05:00
Lokesh Mandvekar 7cf6dbd44d
[CI:DOCS] Tutorial 04 - Include Debian/Ubuntu deps
Signed-off-by: Lokesh Mandvekar <lsm5@fedoraproject.org>
2022-06-06 14:51:57 -04:00
Erik Sjölund 76e9dbf8a6 [CI:DOCS] Fix typos and improve language
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-01-25 21:55:55 +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
Mario Loriedo 6468400446 Update 05-openshift-rootless-build.md
Replace buildah "build" command with "build-using-dockerfile"

Signed-off-by: Mario Loriedo <mario.loriedo@gmail.com>
2021-09-10 11:20:07 +02: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
Francisco M. Casares 592745b270 Minor fixes to Buildah as a library tutorial documentation
Details:
1. CommitOptions struct does not belong to `define` package anymore.
2. Formatting fixes threw by MD lint.

Signed-off-by: Francisco M. Casares <francares@gmail.com>
2021-04-16 11:02:06 -07:00
Daniel J Walsh 4704e6cb3f
Eliminate the use of containers/building import in pkg subdirs
We want to shrink the size of the import when importing pkg from
buildah. This should help us shrink the size of the golang bindings
in podman.

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2021-02-12 12:43:08 -05: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
Toomas Vendelin 0dba767afe Added required devel packages
Signed-off-by: Toomas Vendelin <toomas.vendelin@gmail.com>
2021-01-21 19:23:02 +01:00
OpenShift Merge Robot ffef8a6c0b
Merge pull request #2864 from jsoref/spelling
Spelling
2020-12-23 17:04:31 +01:00
Josh Soref c7963db369 Spelling
Signed-off-by: Josh Soref <jsoref@users.noreply.github.com>
2020-12-21 16:47:18 -05:00
Daniel J Walsh 18f3e8724e
Switch references of /var/run -> /run
Systemd is now complaining or mentioning /var/run as a legacy directory.
It has been many years where /var/run is a symlink to /run on all
most distributions, make the change to the default.

Partial fix for https://github.com/containers/podman/issues/8369

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2020-12-18 06:37:59 -05:00
Daniel J Walsh 2cf9c8f2b8
Fix up code based on codespell
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2020-09-15 16:49:18 -04: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 29e957aef1
Merge pull request #2453 from jskovjyskebankdk/mergeTutorial
Howto for rootless image building from OpenShift
2020-08-11 17:51:10 -04:00
Jesper Skov 66986d187e Howto for rootless image building from OpenShift
Signed-off-by: Jesper Skov <jskov@jyskebank.dk>
2020-08-11 12:25:08 +02:00
Joel Lord 36a56cea58 Update 02-registries-repositories.md
I had a 'unknown flag --creds username:apikey' error message when trying as documented. Adding the '=' has fixed my issues (v.1.15)

Signed-off-by: Joel Lord <joelphy@gmail.com>
2020-07-22 07:16:09 -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 b2e7110255
vendor in latest containers/storage 1.18.0 and containers/common v0.7.0
This vendor moves containers/common/pkg/unshare to containers/storage/pkg/unshare

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2020-03-31 09:56:18 -04:00
Laurent Stacul c42f440f98 Fix image reference in tutorial 4
Signed-off-by: Laurent Stacul <laurent.stacul@gmail.com>

Closes: #2059
Approved by: rhatdan
2020-01-04 01:42:21 +00:00
Daniel J Walsh 8fc5b0116f Start using containers/common
We have moved share code from buildah, podman and others into containers/common.

Specifically for this PR we are moving to use containers/common/pkg/unshare and
containers/common/pkg/cgroups.

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

Closes: #2010
Approved by: QiWang19
2019-12-06 14:37:27 +00: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
Nalin Dahyabhai f0cf07bb60 Move to containers/image v5.0.0
Bump to containers/image's 5.0 release.

Signed-off-by: Nalin Dahyabhai <nalin@redhat.com>

Closes: #1902
Approved by: rhatdan
2019-10-28 15:15:34 +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
Miloslav Trmač 797e618cbe Update c/image to v4.0.1
This requires updating all import paths throughout.

Signed-off-by: Miloslav Trmač <mitr@redhat.com>

Closes: #1891
Approved by: vrothberg
2019-10-04 07:34:03 +00:00
slinydeveloper 6abc01c0f7 Added tutorial on how to include Buildah as library
Signed-off-by: slinkydeveloper <francescoguard@gmail.com>

Closes: #1852
Approved by: rhatdan
2019-09-17 11:08:06 +00:00
Sascha Grunert 567141716e Add `--log-level` command line option and deprecate `--debug`
The previous log-level implementation does not seem to work, which is
now fixed and aligns to other projects like podman and CRI-O. Therefore
the `--debug` flag has been deprecated and is now hidden.

Added documentation as well as integration tests.

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

Closes: #1811
Approved by: rhatdan
2019-08-29 12:49:11 +00: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
TomSweeneyRedHat af8cb28f84 Fix up Tutorial 3 to account for format
Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>

Closes: #1073
Approved by: rhatdan
2018-10-07 10:55:33 +00: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
TomSweeneyRedHat 2ac95ea682 ONBUILD tutorial
Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>

Closes: #808
Approved by: rhatdan
2018-06-24 11:47:59 +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 e9915937ac Rename tutorials.md to README.md in tutorial dir
Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>

Closes: #459
Approved by: rhatdan
2018-02-10 11:14:52 +00:00