Skip to content
This repository has been archived by the owner on Feb 22, 2023. It is now read-only.

Fix pnpm + docker #1385

Merged
merged 6 commits into from
May 5, 2022
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
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
10 changes: 8 additions & 2 deletions .github/workflows/ghcr.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,7 @@ jobs:
runs-on: ubuntu-latest

steps:
- name: checkout
uses: actions/checkout@v2
- uses: actions/checkout@v2

- uses: docker/setup-buildx-action@v1
with:
Expand All @@ -35,9 +34,16 @@ jobs:
type=sha
type=ref,event=tag

- name: Get pnpm-version
id: pnpm-version
run: |
echo "::set-output name=val::$(cat .pnpm-version)"

- uses: docker/build-push-action@v2
with:
context: .
tags: ${{ steps.metadata.outputs.tags }}
labels: ${{ steps.metadata.outputs.labels }}
push: true
build-args: |
PNPM_VERSION=${{ steps.pnpm-version.outputs.val }}
1 change: 1 addition & 0 deletions .pnpm-version
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
6.32.11
92 changes: 12 additions & 80 deletions Dockerfile
Original file line number Diff line number Diff line change
@@ -1,101 +1,33 @@
# ==
# builder
# ==
FROM node:16-alpine

# application builder
FROM node:16 AS builder
ARG PNPM_VERSION

WORKDIR /usr/app
RUN npm install -g pnpm@${PNPM_VERSION}

ARG API_URL
USER node

Comment on lines +7 to 8
Copy link
Member

Choose a reason for hiding this comment

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

With the user here it fails in my case due to "EACCES: permission denied". We can move this sentence just before the ENTRYPOINT.

Suggested change
USER node

Copy link
Contributor Author

Choose a reason for hiding this comment

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

If we move it before the entrypoint without chmoding the copied files, how would the node user have access to the files copied into its home directory?

Copy link
Member

Choose a reason for hiding this comment

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

Why wouldn't it have access to its own directory? I tried these changes and the app runs normally as far as I've seen. Otherwise, I think it needs to be pointed out in the Docker section of the README that BuildKit is required, it did not work for me as it is currently.

# Install pnpm
RUN npm install -g pnpm
WORKDIR /home/node/app

# copy package.json and package-lock.json files
COPY package.json .
COPY pnpm-lock.yaml .
COPY .npmrc .
krysal marked this conversation as resolved.
Show resolved Hide resolved

# install dependencies including local development tools
RUN pnpm install --store=pnpm-store
RUN pnpm fetch

# copy the rest of the content
COPY . /usr/app

# disable telemetry when building the app
ENV NUXT_TELEMETRY_DISABLED=1

# build the application and generate a distribution package
RUN pnpm build

# ==
# development
# ==
# application for development purposes
FROM node:16 AS dev
COPY --chmod=777 . /home/node/app
Copy link
Member

Choose a reason for hiding this comment

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

The --chmod=777 option requires installing BuildKit, this conflicts with the use of a non-root user, can we omit it?.

Suggested change
COPY --chmod=777 . /home/node/app
COPY . /home/node/app

Copy link
Contributor Author

Choose a reason for hiding this comment

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

How does BuildKit conflict with using a non-root user? Do you mean non-root user in the image or running rootless docker?

Copy link
Member

@krysal krysal May 5, 2022

Choose a reason for hiding this comment

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

I meant the option to change permissions with 777 as the value and run it with a non-root user.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It seems like chmod can be replaced with chown without requiring BuildKit.

https://docs.docker.com/engine/reference/builder/#copy


WORKDIR /usr/app

# Install pnpm
RUN npm install -g pnpm

ENV NODE_ENV=development
ENV CYPRESS_INSTALL_BINARY=0

# copy files from local machine
COPY . /usr/app

COPY --from=builder /usr/app/pnpm-store /usr/app/pnpm-store
RUN pnpm install -r --offline
krysal marked this conversation as resolved.
Show resolved Hide resolved

# disable telemetry when building the app
ENV NUXT_TELEMETRY_DISABLED=1

# install dependencies (development dependencies included)
RUN pnpm install --store=pnpm-store

# expose port 8443
EXPOSE 8443

# run the application in development mode
ENTRYPOINT [ "pnpm", "run", "dev" ]

# ==
# production
# ==
# application package (for production)
FROM node:16-alpine AS app

WORKDIR /usr/app

# Install pnpm
RUN npm install -g pnpm

ENV NODE_ENV=production
ENV PLAYWRIGHT_SKIP_BROWSER_GC=1

# copy package.json and package-lock.json files
COPY package.json .
COPY pnpm-lock.yaml .
COPY .npmrc .

# copy the nuxt configuration file
COPY --from=builder /usr/app/nuxt.config.ts .

# copy distribution directory with the static content
COPY --from=builder /usr/app/.nuxt /usr/app/.nuxt

# copy publically-accessible static assets
COPY --from=builder /usr/app/src/static /usr/app/src/static

# Copy over files needed by Nuxt's runtime process
COPY --from=builder /usr/app/src/locales /usr/app/src/locales
COPY --from=builder /usr/app/src/utils /usr/app/src/utils
COPY --from=builder /usr/app/src/constants /usr/app/src/constants
COPY --from=builder /usr/app/src/server-middleware /usr/app/src/server-middleware
COPY --from=builder /usr/app/pnpm-store /usr/app/pnpm-store
ARG API_URL

RUN pnpm install --frozen-lockfile --store=pnpm-store
RUN pnpm i18n
# build the application and generate a distribution package
RUN pnpm build:only

# set app serving to permissive / assigned
ENV NUXT_HOST=0.0.0.0
Expand Down
3 changes: 2 additions & 1 deletion Dockerfile.playwright
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
ARG PLAYWRIGHT_VERSION
ARG PNPM_VERSION

FROM mcr.microsoft.com/playwright:v${PLAYWRIGHT_VERSION}-focal

RUN npm install -g pnpm
RUN npm install -g pnpm@${PNPM_VERSION}
26 changes: 17 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ We use [Volta](https://volta.sh/) to manage our local environment tools. Please
Once you have volta installed, manually install `pnpm` using volta. [Volta does not currently officially support `pnpm`](https://github.com/volta-cli/volta/issues/737) so this is a stop gap solution until that support is implemented:

```bash
volta install pnpm
volta install pnpm@$(cat .pnpm-version)
```

Run the following commands in order to have the code up and running on your machine:
Expand Down Expand Up @@ -74,18 +74,14 @@ You can find the local IP address Nuxt uses by looking at the output of `nuxt de

You will need to regenerate the certificate if this IP address changes for any reason, like by enabling a VPN or changing networks.

### Docker setup
### Choosing which API to use

Alternatively, you can use Docker to build and run the application. You just have to run:
You don't need to have the Openverse API running locally to be able to run the frontend application. It's configured to communicate, by default, with the [production API](https://api.openverse.engineering) that's already publicly available. If you need to test against changes in your local API, set the `API_URL` environment variable when run the development server.

```bash
docker-compose up
```shell
API_URL=http://localhost:8000 pnpm dev
```

You should now have the application running and accessible at http://localhost:8443.

You don't need to have the Openverse API running locally to be able to run the frontend application. It's configured to communicate, by default, with the [API](https://api.openverse.engineering) that's already publicly available. If you wish, you can change the URL of the API that's used during development by setting the `API_URL` environment variable.

### Standalone and embedded modes

The application can run in two modes. By default, it runs in embedded mode, which is loaded in an iframe on [WordPress.org/openverse](https://make.wordpress.org/openverse). It has a small header without logo and no footer.
Expand All @@ -112,6 +108,18 @@ If you need to run an HTTP version (for example, if you're testing against third
ngrok http 8443 -host-header="localhost:8443"
```

## Docker and Openverse frontend

We do not currently support local development using Docker or `docker-compose`. It was supported in the past, but it was not used by the core contributors. It remained broken for many months without ever being noticed, so the assumption is that it was also not being used active community members. Local `nuxt` development is still easy across platforms, so maintaining a separate Docker development stack for the frontend did not make sense.

However, we do build and actively deploy the frontend using Docker images. If you wish to build the production image for yourself, run the following:

```shell
PNPM_VERISON=$(cat .pnpm-version) docker build . openverse-frontend:latest
```

You can also find the latest `openverse-frontend` images on our [GitHub packages page](https://github.com/WordPress/openverse-frontend/pkgs/container/openverse-frontend).

## Formatting and Linting

The code in this repository is formatted using `prettier`. If you have prettier setup in your code editor it should work out of the box; otherwise you can use the `pnpm lint:fix` script to format and fix lint errors in your code. Checks are run to lint your code and validate the formatting on git precommit using [husky](https://github.com/typicode/husky).
Expand Down
1 change: 1 addition & 0 deletions bin/playwright.sh
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ export USER_ID=${USER_ID:-$(id -u)}
export PLAYWRIGHT_ARGS=$@
export PLAYWRIGHT_VERSION=$(version)
export TEST_COMMAND=${TEST_COMMAND:-test:playwright:local}
export PNPM_VERSION=$(cat .pnpm-version)

echo Running Playwright v$PLAYWRIGHT_VERSION as $USER_ID with Playwright arguments $PLAYWRIGHT_ARGS

Expand Down
12 changes: 0 additions & 12 deletions docker-compose.yml

This file was deleted.