Error: EISDIR: illegal operation on a directory error while generating project in Docker

[kolorobot]

I have a long running project in Hexo (currently 3.9.0), and recently I wanted to update it to the newest version (6.3.0). Once done, the project works properly locally (macOS) and builds properly with Docker locally, but when running it on GitLab CI I receive the following error:

Error: EISDIR: illegal operation on a directory, open ''

My package.json:

{
  "name": "my-project",
  "version": "1.0.0",
  "private": true,
  "hexo": {
    "version": "6.3.0"
  },
  "scripts": {
    "server": "./node_modules/hexo/bin/hexo server --draft",
    "generate": "./node_modules/hexo/bin/hexo generate"
  },
  "dependencies": {
    "hexo": "6.3.0",
    "hexo-generator-archive": "2.0.0",
    "hexo-generator-category": "2.0.0",
    "hexo-generator-feed": "3.0.0",
    "hexo-generator-index": "3.0.0",
    "hexo-generator-tag": "2.0.0",
    "hexo-renderer-ejs": "2.0.0",
    "hexo-renderer-marked": "6.0.0",
    "hexo-renderer-stylus": "2.1.0",
    "hexo-server": "3.0.0"
  }
}

Dockerfile for testing:

FROM node:18.15.0-alpine3.16

WORKDIR /app
COPY . .

RUN apk update && apk add --no-cache yarn

CMD ["sh", "-c", "yarn install && yarn run generate && echo \"There are $(find public -type f | wc -l) files in public\""]

I run the build locally with node 18 or with the above Dockerfile all is working just fine. When I do it on GitLab CI it does not work. My GitLab workflow file:

image: docker:20.10.23

variables:
  DOCKER_TLS_CERTDIR: ""

services:
  - docker:20.10.23-dind

before_script:
  - docker info

deploy:
  stage: deploy
  only:
    - master
  script:
    - docker build -t my-project .
    - docker run my-project

I ended up with Hexo 3.9.0 and node 12, because in any other configuration either I get zero size files generated or the above mentioned error.

Even when I used Hexo 3.9.0 with node 14 and later I get the same errors. So I assume this is issue with Hexo and node runtime.

The only workaround I found is to generate the project locally (on my local computer), store in GitLab and then push it to server (I am using lftp for that) without generating it in GitLab.

Am I missing something? Is there anything I should do / try to fix the issue? 🙏

Note: I also asked this question on SO - https://stackoverflow.com/questions/75904647/error-eisdir-illegal-operation-on-a-directory-error-while-generating-project-i

[yoshinorin]

@kolorobot

Questions

1. Would you give us more error logs?
   a. We want to know which directory is causing the problem.
2. Would the same problem occur with npm? (not yarn)
3. Could you tell me the version of yarn you are using?

[kolorobot]

@yoshinorin

Would you give us more error logs? We want to know which directory is causing the problem.

Every directory from my project.index.html files are not generated for each article, the rest of files are. I could give you access to the source code on GitLab, if you provide me with details. This project is related to that blog: https://blog.qalabs.pl.

Please note, that I removed the problematic folder, and that the issue appeared for other folders.

$ ./node_modules/hexo/bin/hexo generate
INFO  Validating config
INFO  Start processing
INFO  Files loaded in 1.13 s
FATAL {
  err: [Error: EISDIR: illegal operation on a directory, open '/builds/qalabs/blog/blog.qalabs.pl/public/narzedzia/git-pierwsze-kroki'] {
    errno: -21,
    code: 'EISDIR',
    syscall: 'open',
    path: '/builds/qalabs/blog/blog.qalabs.pl/public/narzedzia/git-pierwsze-kroki'
  }
} Something's wrong. Maybe you can find the solution here: %s https://hexo.io/docs/troubleshooting.html
INFO  Generated: atom.xml
INFO  Generated: tags/index.html
INFO  Generated: pytest/test-failure-vs-error
INFO  Generated: junit-selenium/selenium-4-basic-auth
INFO  Generated: python-selenium/webdriver-manager-pierwsze-kroki
INFO  Generated: narzedzia/python-pycharm
INFO  Generated: tags/junit5/index.html
INFO  Generated: tags/java/index.html
INFO  Generated: tags/python/index.html
INFO  Generated: tags/pytest/index.html
INFO  Generated: tags/cmder/index.html
INFO  Generated: tags/git/index.html
INFO  Generated: tags/narzedzia/index.html
INFO  Generated: tags/chrome/index.html
INFO  Generated: tags/firefox/index.html
INFO  Generated: tags/selenium/index.html
INFO  Generated: tags/gradle/index.html
INFO  Generated: tags/intellij/index.html
INFO  Generated: tags/homebrew/index.html
INFO  Generated: tags/iterm/index.html
INFO  Generated: tags/macos/index.html
INFO  Generated: tags/pycharm/index.html
INFO  Generated: tags/virtualenv/index.html
INFO  Generated: tags/requests/index.html
INFO  Generated: tags/rest/index.html
INFO  Generated: tags/api/index.html
INFO  Generated: tags/trello/index.html
INFO  Generated: tags/wzorce/index.html
INFO  Generated: tags/page-object-pattern/index.html
INFO  Generated: tags/tempfile/index.html
INFO  Generated: tags/page-object/index.html
INFO  Generated: selenium/selenium-manager
INFO  Generated: java/przygotowanie-srodowiska
INFO  Generated: junit/junit5-pierwsze-kroki
INFO  Generated: archives/index.html
INFO  Generated: archives/2018/index.html
INFO  Generated: archives/2018/02/index.html
INFO  Generated: archives/2018/03/index.html
INFO  Generated: archives/2018/04/index.html
INFO  Generated: archives/2018/05/index.html
INFO  Generated: archives/2018/06/index.html
INFO  Generated: archives/2018/08/index.html
INFO  Generated: archives/2019/index.html
INFO  Generated: archives/2019/01/index.html
INFO  Generated: archives/2019/05/index.html
INFO  Generated: archives/2019/09/index.html
INFO  Generated: archives/2019/11/index.html
INFO  Generated: archives/2020/index.html
INFO  Generated: archives/2020/03/index.html
INFO  Generated: archives/2022/index.html
INFO  Generated: archives/2022/02/index.html
INFO  Generated: archives/2023/index.html
INFO  Generated: archives/2023/03/index.html
INFO  Generated: junit-selenium/selenium-4-chrome-devtools-protocol
INFO  Generated: junit-selenium/selenium-page-factory
INFO  Generated: junit-selenium/optymalizacja-konfiguracji-i-uruchomienia
INFO  Generated: pytest/pytest-katalogi-tymczasowe
INFO  Generated: junit-selenium/selenium-webdriver-manager-pierwsze-kroki
INFO  Generated: narzedzia/java-selenium-macos
INFO  Generated: narzedzia/selenium-przegladarki
INFO  Generated: pytest/pytest-pierwsze-kroki
INFO  Generated: index.html
INFO  Generated: fancybox/blank.gif
INFO  Generated: fancybox/helpers/fancybox_buttons.png
INFO  Generated: narzedzia/git-cmder/cmder-default-task.png
INFO  Generated: junit-selenium/wprowadzenie-do-projektu/1-todomvc.png
INFO  Generated: pytest/pytest-fixture-scope-teardown/pytest-list-1-card.png
INFO  Generated: junit-selenium/odpowiedzialnosc-metod-testowych/duplicates-after.png
INFO  Generated: junit-selenium/page-object-pattern-pierwsze-kroki/todo-mvc-tests-diagram.png
INFO  Generated: junit-selenium/repeated-tests/repeated-tests-1.png
INFO  Generated: narzedzia/git-pierwsze-kroki/gitk_01.png
INFO  Generated: page/3/index.html
INFO  Generated: tags/java/page/2/index.html
INFO  Generated: tags/selenium/page/2/index.html
INFO  Generated: archives/page/2/index.html
INFO  Generated: fancybox/fancybox_loading.gif
INFO  Generated: fancybox/[email protected]
INFO  Generated: fancybox/fancybox_overlay.png
INFO  Generated: fancybox/fancybox_sprite.png
INFO  Generated: fancybox/[email protected]
INFO  Generated: favicon.png
INFO  Generated: narzedzia/git-cmder/cmder-new-console.png
INFO  Generated: narzedzia/git-cmder/cmder-restart-or-duplicate.png
INFO  Generated: narzedzia/git-cmder/cmder-settings.png
INFO  Generated: narzedzia/git-cmder/cmder-split.png
INFO  Generated: narzedzia/git-cmder/git-bash.png
INFO  Generated: junit-selenium/wprowadzenie-do-projektu/3-test-results.png
INFO  Generated: junit-selenium/wprowadzenie-do-projektu/4-create-todo.png
INFO  Generated: junit-selenium/wprowadzenie-do-projektu/5-edit-todo.png
INFO  Generated: junit-selenium/wprowadzenie-do-projektu/6-clear-completed.png
INFO  Generated: pytest/pytest-fixture-scope-teardown/pytest-list-4-cards.png
INFO  Generated: pytest/pytest-fixture-scope-teardown/pytest-list-no-cards.png
INFO  Generated: junit-selenium/odpowiedzialnosc-metod-testowych/duplicates-before.png
INFO  Generated: narzedzia/git-pierwsze-kroki/gitlab_01.png
INFO  Generated: narzedzia/git-pierwsze-kroki/gitlab_03.png
INFO  Generated: narzedzia/git-pierwsze-kroki/gitlab_05.png
INFO  Generated: archives/page/3/index.html
INFO  Generated: page/2/index.html
INFO  Generated: css/fonts/iconfont.eot
INFO  Generated: img/team/maciej-chmielarz.jpg
INFO  Generated: narzedzia/git-cmder/cmder-settings-tasks.png
INFO  Generated: junit-selenium/odpowiedzialnosc-metod-testowych/refactor-extract.png
INFO  Generated: junit-selenium/repeated-tests/repeated-tests-0.png
INFO  Generated: narzedzia/git-pierwsze-kroki/gitlab_02.png
INFO  Generated: narzedzia/git-pierwsze-kroki/gitlab_04.png
INFO  Generated: narzedzia/git-pierwsze-kroki/gitlab_06.png
INFO  Generated: narzedzia/git-pierwsze-kroki/gitlab_07.png
INFO  Generated: cookieinfo/cookieinfo.min.js
INFO  Generated: js/script.js
INFO  Generated: css/gist.css
INFO  Generated: fancybox/jquery.fancybox.css
INFO  Generated: fancybox/helpers/jquery.fancybox-buttons.css
INFO  Generated: fancybox/helpers/jquery.fancybox-buttons.js
INFO  Generated: fancybox/helpers/jquery.fancybox-media.js
INFO  Generated: fancybox/helpers/jquery.fancybox-thumbs.css
INFO  Generated: fancybox/helpers/jquery.fancybox-thumbs.js
INFO  Generated: css/style.css
INFO  Generated: fancybox/jquery.fancybox.js
INFO  Generated: fancybox/jquery.fancybox.pack.js
INFO  Generated: narzedzia/git-cmder/cmder-vim.png
INFO  Generated: junit-selenium/wprowadzenie-do-projektu/2-run-tests.png
INFO  Generated: css/fonts/iconfont.svg
INFO  Generated: css/fonts/iconfont.ttf
INFO  Generated: css/fonts/iconfont.woff
INFO  Generated: img/team/rafal-borowiec.jpg
error Command failed with exit code 2.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
section_end:1680340073:step_script
�[0Ksection_start:1680340073:cleanup_file_variables
�[0K�[0K�[36;1mCleaning up project directory and file based variables�[0;m�[0;m
section_end:1680340074:cleanup_file_variables
�[0K�[31;1mERROR: Job failed: exit code 2
�[0;m

Would the same problem occur with npm? (not yarn)

Tested with npm and yarn. Exactly the same happens. I believe this is related to node version used, because the same project works perfectly find with node 12 (as I stated). At the moment I upgrade node.

Could you tell me the version of yarn you are using?

(16/16) Installing yarn (1.22.19-r0)

[stevenjoezhang]

See also #4682

[kolorobot]

@yoshinorin I checked the related issue #4682 and and I changed post_asset_folder to false

Now it runs differently. What it does - it generates much less files (101 instead of 150 in the working version) where each blog post becomes a file with HTML contents instead of directory with index.html and all the assets:

Before (correct, original, Hexo 3, Node 12):

├──  junit-selenium
│  ├──  odpowiedzialnosc-metod-testowych
│  │  ├──  duplicates-after.png
│  │  ├──  duplicates-before.png
│  │  ├──  index.html
│  │  └──  refactor-extract.png
│  ├──  optymalizacja-konfiguracji-i-uruchomienia
│  │  └──  index.html
│  ├──  page-object-pattern-pierwsze-kroki
│  │  ├──  index.html
│  │  └──  todo-mvc-tests-diagram.png
│  ├──  repeated-tests
│  │  ├──  index.html
│  │  ├──  repeated-tests-0.png
│  │  └──  repeated-tests-1.png
│  ├──  selenium-4-basic-auth
│  │  └──  index.html
│  ├──  selenium-4-chrome-devtools-protocol
│  │  └──  index.html
│  ├──  selenium-page-factory
│  │  └──  index.html
│  ├──  selenium-webdriver-manager-pierwsze-kroki
│  │  └──  index.html
│  └──  wprowadzenie-do-projektu
│     ├──  1-todomvc.png
│     ├──  2-run-tests.png
│     ├──  3-test-results.png
│     ├──  4-create-todo.png
│     ├──  5-edit-todo.png
│     ├──  6-clear-completed.png
│     └──  index.html

After (Hexo 6, Node 18, post_asset_folder: false)

├──  junit-selenium
│  ├──  odpowiedzialnosc-metod-testowych                  <- This is actually file with `HTML` contents
│  ├──  optymalizacja-konfiguracji-i-uruchomienia
│  ├──  page-object-pattern-pierwsze-kroki
│  ├──  repeated-tests
│  ├──  selenium-4-basic-auth
│  ├──  selenium-4-chrome-devtools-protocol
│  ├──  selenium-page-factory
│  ├──  selenium-webdriver-manager-pierwsze-kroki
│  └──  wprowadzenie-do-projektu

No errors in logs.

[kolorobot]

@yoshinorin @stevenjoezhang

After digging more into related issue, I believe I found and implemented the workaround.

1. I restored default value to post_asset_folder (true)
2. I modified permalink property for each blog post and I appended / to it:

Before:

permalink: selenium/selenium-manager

After:

permalink: selenium/selenium-manager/

Once this was done, all started to work like a charm.

This comment I initially ignored, but then I investigated it further: #4682 (comment)

This could be potentially added to the official troubleshooting page.

[yoshinorin]

@kolorobot
Sorry late reply.
We will try to fix it if possible.

Thank you for your investigation and advice :)

[D-Sketon]

Front-matter|Hexo

Overrides the default permalink of the post.
Permalink should end with / or .html

Maybe make the permalinks more flexible?

[yoshinorin]

Maybe make the permalinks more flexible?

Or, we should override the permalink forcibly if the EISDIR error will occur in this condition (post_asset_folder (true)). Also, we have to show a warning message.

https://hexo.io/docs/configuration#URL