Skip to content
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

Jump to bottom

Add podman container install docs #3039

Merged
merged 1 commit into from
Jul 18, 2023
Merged

Add podman container install docs #3039

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
22 changes: 15 additions & 7 deletions docs/prepare-your-dev-environment.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,6 @@ This document goes through the development dependencies one requires in order to

1. Configure `GOPATH` as an OS environment variable in your shell (a requirement of some dependencies for `make generate`). If you want to keep the default path, you can add something like `GOPATH=$(go env GOPATH)` to your shell's profile/RC file.

1. Append `export GO111MODULE=auto` to your shell's profile file.
1. Read [New module changes in Go 1.16](https://go.dev/blog/go116-module-changes) for more information.

1. Install [Python 3.6+](https://www.python.org/downloads), if you haven't already. You will also need `python-setuptools` installed, if you don't have it installed already.

1. Install the [az client](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli), if you haven't already.
Expand All @@ -21,7 +18,20 @@ This document goes through the development dependencies one requires in order to

1. Install the relevant packages required for your OS defined below.

1. Install [Podman](https://podman.io/getting-started/installation) and [podman-docker](https://developers.redhat.com/blog/2019/02/21/podman-and-buildah-for-docker-users#) if you haven't already, used for building container images.
1. Install [Podman](https://podman.io/getting-started/installation) and [podman-docker](https://developers.redhat.com/blog/2019/02/21/podman-and-buildah-for-docker-users#) if you haven't already. Podman is used for building container images and running the installer.
1. Podman needs to be running in daemon mode when running the RP locally.

On Linux, you can set this up to automatically start via socket activation with::

```bash
systemctl --user enable podman.socket
```

If you're using podman-machine, you will need to export the socket, for example::

```bash
export ARO_PODMAN_SOCKET=unix:///$HOME/.local/share/containers/podman/machine/qemu/podman.sock
```

1. Run for `az acr login` compatability

Expand All @@ -34,12 +44,10 @@ This document goes through the development dependencies one requires in order to
### Fedora / RHEL Packages

1. Install the `gpgme-devel`, `libassuan-devel`, and `openssl` packages.
> `sudo dnf install -y gpgme-devel libassuan-devel openssl`
> `sudo dnf install -y gpgme-devel libassuan-devel openssl podman`

> __NOTE:__: If using RHEL, register the system with `subscription-manager register`, and then enable the [CodeReady Linux Builder](https://access.redhat.com/articles/4348511) repository to install *-devel packages. For other packages not in the base repositories, such as OpenVPN, you can [enable the EPEL repository](https://docs.fedoraproject.org/en-US/epel/#_quickstart) to install them.

1. Optionally install [Docker 17.05+](https://docs.docker.com/engine/install/fedora/) or later as an alternative to podman.

### Debian Packages

Install the `libgpgme-dev` package.
Expand Down