[
https://issues.apache.org/jira/browse/CASSANDRA-13915?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16191621#comment-16191621
]
Jason Brown commented on CASSANDRA-13915:
-----------------------------------------
bq. Dockerfile and docker-compose.yml are the default names for working with
Docker-related projects
sgtm. as stated above, I am a container noob.
bq. you two fine with me adding the doc/build directory to the ant realclean?
totally legit: {{realclean}} *should* clean all build artifacts.
When I build the docs, there's the message at the end:
{code}
The locally built documentation can be found here:
open build/html/index.html
{code}
However, when I do this on ubuntu 17.04, I get the following error:
{code}
$ open build/html/index.html
Couldn't get a file descriptor referring to the console
{code}
A naive internet search reveals that {{open}} [isn't quite what we
want|https://ubuntuforums.org/showthread.php?t=2124061}. How did you test this?
Next error: after I build the docs a few times, on the same linux install, I
run {{ant realclean}} again, which produces this error:
{code}
BUILD FAILED
/opt/dev/cassandra/build.xml:196: Unable to delete directory
/opt/dev/cassandra/build/test/lib
{code}
A quick look shows everything in {{/opt/dev/cassandra/build/}} is now owned by
root, and I need to {{sudo rm -rf build}} to clean it up. Which, of course,
leads to:
{code}
BUILD FAILED
/opt/dev/cassandra/build.xml:207: Unable to delete file
/opt/dev/cassandra/doc/build/doctrees/configuration/index.doctree
{code}
Once again, {{sudo rm -rf}}. Can you change the privileges of the artifacts
that get generated, both in ./build and ./doc/build?
UPDATE: I tried out all these commands on a Mac (High Sierra), and after
installing Docker, everything was much smoother. No permissions issues for
{{ant realclean}}, and {{open}} worked correctly. At a minimum, the
{{realclean}} problem needs to be fixed as I suspect we'll have it part of thew
automation for building the online docs hosted on cassandra.apache.org. For
{{open}}, either remove the whole statement or add a note saying "mac only" or
something. [~rustyrazorblade] thoughts?
> Create a Docker container to build the docs
> -------------------------------------------
>
> Key: CASSANDRA-13915
> URL: https://issues.apache.org/jira/browse/CASSANDRA-13915
> Project: Cassandra
> Issue Type: Improvement
> Reporter: Joaquin Casares
> Assignee: Joaquin Casares
>
> As requested by [~rustyrazorblade], I will be adding a Docker container to
> build the docs without any prereqs (other than Docker).
--
This message was sent by Atlassian JIRA
(v6.4.14#64029)
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
