| |
@@ -48,28 +48,46 @@
|
| |
|
| |
#### 1. Setup your system
|
| |
|
| |
- sudo dnf install git gettext python2-genshi python-lxml python-setuptools python-dateutil \
|
| |
- python-dogpile-cache babel python-feedparser fedfind python-requests python2-babel
|
| |
+ Since the build process for these pages depend on python2 packages that are no longer packaged in Fedora, the build process and local test server may be run using [podman](https://podman.io/). Podman should be installed by default on Fedora Workstation, for other Fedora releases:
|
| |
|
| |
- sudo dnf groups install 'Web Server'
|
| |
+ sudo dnf install podman
|
| |
|
| |
#### 2. Clone the fedora-websites repo
|
| |
|
| |
git clone https://pagure.io/fedora-websites.git
|
| |
|
| |
- #### 3. Enter the directory of the website you want to work on
|
| |
- For example, if you want to work on getfedora.org, use:
|
| |
+ #### 3. Build the fedora-websites image
|
| |
|
| |
- cd fedora-websites/getfedora.org
|
| |
+ We need a podman image with the dependencies installed, to build the image from the provided Dockerfile, run the following in the newly checked out `fedora-websites` directory:
|
| |
|
| |
- #### 4. Launch a test instance
|
| |
+ podman build -t fedora-websites .
|
| |
+
|
| |
+ #### 4. Enter the build environment container
|
| |
+
|
| |
+ Run podman specifying the current directory as the container working directory and the `fedora-websites` image:
|
| |
+
|
| |
+ podman run -it -p 5000:5000 -v "$(pwd):/opt/:z" -w /opt fedora-websites
|
| |
+
|
| |
+ #### 5. Enter the directory of the website you want to work on
|
| |
+
|
| |
+ For example, if you want to work on alt.fedoraproject.org, use:
|
| |
+
|
| |
+ cd alt.fedoraproject.org
|
| |
+
|
| |
+ #### 6. Launch a test instance
|
| |
|
| |
make en test
|
| |
|
| |
- #### 5. Stop the test instance
|
| |
+ This will run the build, start httpd to serve the built content at [localhost:5000](http://localhost:5000/).
|
| |
+
|
| |
+ #### 7. Stop the test instance
|
| |
|
| |
make stoptest
|
| |
|
| |
**Note:** if you have caching problems you can clean the instance even more:
|
| |
|
| |
make veryclean
|
| |
+
|
| |
+ #### 8. Exit the container
|
| |
+
|
| |
+ exit
|
| |
Required build dependencies are no longer available on later versions of
Fedora, update the build and test procedure to use a podman container
running an older version of Fedora.
This is inspired by PR:1119, and is a stopgap until #1009 is closed (or everything is moved to the new system).