action #114325
openpublish docu
Description
doc.opensuse.org
https://en.opensuse.org/SDB:Official_documentation
Ping Frank Sundermeyer or Lukas Kucharczyk about it
Updated by lkocman over 1 year ago
- Assignee set to lkocman
I'm on this one with Frank
Frank updated https://github.com/openSUSE/doc-o-o/pull/27
and I did the deployment (with heroes vpn on, and requested accesses from heroes to pinot-o-o/communty-o-o. doc.opensuse.org now displays 15.5 but I have to figure out what went wrong with "set_current_version" at the bottom.
lkocman@localhost:~/Workspace/opensuse/doc-o-o> bundle install --path vendor/bundle
Fetching gem metadata from https://rubygems.org/...........
Fetching https://github.com/ashmaroli/jekyll-locale.git
Fetching https://github.com/opensuse/jekyll-theme.git
Fetching public_suffix 4.0.6
Installing public_suffix 4.0.6
Fetching addressable 2.8.0
Installing addressable 2.8.0
Using bundler 1.16.1
Fetching colorator 1.1.0
Installing colorator 1.1.0
Fetching concurrent-ruby 1.1.9
Installing concurrent-ruby 1.1.9
Fetching eventmachine 1.2.7
Installing eventmachine 1.2.7 with native extensions
Fetching http_parser.rb 0.8.0
Installing http_parser.rb 0.8.0 with native extensions
Fetching em-websocket 0.5.3
Installing em-websocket 0.5.3
Fetching ffi 1.15.5
Installing ffi 1.15.5 with native extensions
Fetching forwardable-extended 2.6.0
Installing forwardable-extended 2.6.0
Fetching i18n 1.8.11
Installing i18n 1.8.11
Fetching sassc 2.4.0
Installing sassc 2.4.0 with native extensions
Fetching jekyll-sass-converter 2.1.0
Installing jekyll-sass-converter 2.1.0
Fetching rb-fsevent 0.11.0
Installing rb-fsevent 0.11.0
Fetching rb-inotify 0.10.1
Installing rb-inotify 0.10.1
Fetching listen 3.7.1
Installing listen 3.7.1
Fetching jekyll-watch 2.2.1
Installing jekyll-watch 2.2.1
Fetching rexml 3.2.5
Installing rexml 3.2.5
Fetching kramdown 2.3.1
Installing kramdown 2.3.1
Fetching kramdown-parser-gfm 1.1.0
Installing kramdown-parser-gfm 1.1.0
Fetching liquid 4.0.3
Installing liquid 4.0.3
Fetching mercenary 0.4.0
Installing mercenary 0.4.0
Fetching pathutil 0.16.2
Installing pathutil 0.16.2
Fetching rouge 3.27.0
Installing rouge 3.27.0
Fetching safe_yaml 1.0.5
Installing safe_yaml 1.0.5
Fetching unicode-display_width 1.8.0
Installing unicode-display_width 1.8.0
Fetching terminal-table 2.0.0
Installing terminal-table 2.0.0
Fetching jekyll 4.2.1
Installing jekyll 4.2.1
Fetching jekyll-archives 2.2.1
Installing jekyll-archives 2.2.1
Using jekyll-locale 0.5.1 from https://github.com/ashmaroli/jekyll-locale.git (at master@dc5c46c)
Fetching jekyll-paginate 1.1.0
Installing jekyll-paginate 1.1.0
Using jekyll-theme-opensuse 0.7.1 from https://github.com/opensuse/jekyll-theme.git (at master@cd9f092)
Bundle complete! 3 Gemfile dependencies, 32 gems now installed.
Bundled gems are installed into `./vendor/bundle`
lkocman@localhost:~/Workspace/opensuse/doc-o-o> ls
archive _config.yml development doc-config Gemfile.lock _includes _layouts Makefile README.md tw-docs-config
assets _data doc-build-script Gemfile htaccess-doc-o-o index.html LICENSE publishusers rn-config vendor
lkocman@localhost:~/Workspace/opensuse/doc-o-o> make build
bundle exec jekyll build
Configuration file: /home/lkocman/Workspace/opensuse/doc-o-o/_config.yml
Theme Config file: /home/lkocman/Workspace/opensuse/doc-o-o/vendor/bundle/ruby/2.5.0/bundler/gems/jekyll-theme-cd9f09233373/_config.yml
Source: /home/lkocman/Workspace/opensuse/doc-o-o
Destination: /home/lkocman/Workspace/opensuse/doc-o-o/_site
Incremental build: disabled. Enable with --incremental
Generating...
done in 0.058 seconds.
Auto-regeneration: disabled. Use --watch to enable.
cp "htaccess-doc-o-o" "_site/.htaccess"
lkocman@localhost:~/Workspace/opensuse/doc-o-o> make upload
bundle exec jekyll build
Configuration file: /home/lkocman/Workspace/opensuse/doc-o-o/_config.yml
Theme Config file: /home/lkocman/Workspace/opensuse/doc-o-o/vendor/bundle/ruby/2.5.0/bundler/gems/jekyll-theme-cd9f09233373/_config.yml
Source: /home/lkocman/Workspace/opensuse/doc-o-o
Destination: /home/lkocman/Workspace/opensuse/doc-o-o/_site
Incremental build: disabled. Enable with --incremental
Generating...
done in 0.059 seconds.
Auto-regeneration: disabled. Use --watch to enable.
cp "htaccess-doc-o-o" "_site/.htaccess"
test -s /home/lkocman/Workspace/opensuse/doc-o-o/publishusers && source /home/lkocman/Workspace/opensuse/doc-o-o/publishusers; \
if [[ $userdoc ]] && [[ $port ]] && [[ $server ]]; then \
echo "Syncing documentation."; \
rsync -lr -v "_site/" -e "ssh -p $port" ${userdoc}@${server}:doc.opensuse.org/htdocs/ ; \
else \
exit 1; \
fi
Syncing documentation.
The authenticity of host 'community.infra.opensuse.org (192.168.47.6)' can't be established.
ECDSA key fingerprint is SHA256:RIdKjToNsiRO6+3+Q2NIbUkr9rqsBd76Z+sgTbTCFjQ.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added 'community.infra.opensuse.org,192.168.47.6' (ECDSA) to the list of known hosts.
sending incremental file list
.htaccess
index.html
archive/index.html
assets/css/app.css
assets/css/main.css
assets/images/cover-autoyast.svg
assets/images/cover-gnome.svg
assets/images/cover-reference.svg
assets/images/cover-release.svg
assets/images/cover-security.svg
assets/images/cover-startup.svg
assets/images/cover-tuning.svg
assets/images/cover-virtualization.svg
de/index.html
de/archive/index.html
de/development/index.html
development/index.html
doc-config/bin/set_current_version
es/index.html
es/archive/index.html
es/development/index.html
fr/index.html
fr/archive/index.html
fr/development/index.html
hi/index.html
hi/archive/index.html
hi/development/index.html
it/index.html
it/archive/index.html
it/development/index.html
ja/index.html
ja/archive/index.html
ja/development/index.html
pt-BR/index.html
pt-BR/archive/index.html
pt-BR/development/index.html
rn-config/bin/update_release_notes
rn-config/etc/releasenotes
rn-config/etc/update_release_notes.conf
tw-docs-config/bin/update_tw_docs
tw-docs-config/systemd/update_tw_docs.service
tw-docs-config/systemd/update_tw_docs.timer
uk/index.html
uk/archive/index.html
uk/development/index.html
zh-CN/index.html
zh-CN/archive/index.html
zh-CN/development/index.html
sent 275,695 bytes received 11,264 bytes 18,513.48 bytes/sec
total size is 1,272,413 speedup is 4.43
lkocman@localhost:~/Workspace/opensuse/doc-o-o> make set_docs_current_version
test -s /home/lkocman/Workspace/opensuse/doc-o-o/publishusers && source /home/lkocman/Workspace/opensuse/doc-o-o/publishusers; \
if [[ $userdoc ]] && [[ $port ]] && [[ $server ]]; then \
echo "Syncing docs config."; \
rsync -lr -v doc-config/{bin,etc} -e "ssh -p $port" "${userdoc}@${server}":'~' ; \
else \
exit 1; \
fi
Syncing docs config.
sending incremental file list
rsync: [sender] link_stat "/home/lkocman/Workspace/opensuse/doc-o-o/doc-config/etc" failed: No such file or directory (2)
bin/set_current_version
sent 129 bytes received 42 bytes 342.00 bytes/sec
total size is 424 speedup is 2.48
rsync error: some files/attrs were not transferred (see previous errors) (code 23) at main.c(1330) [sender=3.2.3]
make: *** [Makefile:74: upload_doc_config] Error 23
lkocman@localhost:~/Workspace/opensuse/doc-o-o>
Updated by lkocman over 1 year ago
Just to share my .ssh config for tracking of history
lkocman@localhost:/etc/openvpn> cat ~/.ssh/config
Host pontifex
Hostname pontifex.infra.opensuse.org
User lkocman
Host community
Hostname community.infra.opensuse.org
User lkocman
Host pinot
Hostname pinot.infra.opensuse.org
User relsync
Host alp
Hostname 192.168.122.194
User root
Host mirror
Hostname mirror.luboskocman.com
User root
Host openqa.opensuse.org
HostName gate.opensuse.org
Port 2213
User lkocman
Updated by lkocman over 1 year ago
I suppose that these files should be also under git
relsync@community:~> cat etc/releasenotes
# Configuration file for release notes from OBS to doc.o.o
# ========================================================
#
#(Only edit this file within the Git repo https://github.com/openSUSE/doc-o-o!
# Other changes may be overwritten.)
#
# Format:
# DISTVERSION|PRODUCT_NAME|PRODUCT_VERSION|RELEASE_NOTES_NAME|PRODUKT_ARCHS
#
# DISTVERSION : openSUSE version (from OBS download tree like: obs://openSUSE:13.1:Update/standard)
# PRODUCT_NAME : Name of the product (will appear in tree)
# PRODUCT_VERSION : official Version number (12.3 or 13.1 - will appear in tree)
# RELEASE_NOTES_NAME : the name of the release-notes RPM
# PRODUKT_ARCHS : supported architectures (space separated)
# TARGET_REL_DIRS : target base directory where release notes should be unpacked (can/should stay empty)
#
# TODO: phase out factory and only provide Tumbleweed
obs://Documentation:Auto/openSUSE_Factory|openSUSE|factory|release-notes-openSUSE-TW|x86_64|
obs://Documentation:Auto/openSUSE_Factory|openSUSE|Tumbleweed|release-notes-openSUSE-TW|x86_64|
obs://Documentation:Auto/openSUSE_Leap_15.2|openSUSE|Leap/15.2|release-notes-openSUSE-L152|x86_64|
obs://Documentation:Auto/openSUSE_Leap_15.3|openSUSE|Leap/15.3|release-notes-openSUSE-L153|x86_64|
obs://Documentation:Auto/15.4|openSUSE|Leap/15.4|release-notes-openSUSE-L154|x86_64|
relsync@community:~> cat etc/update_release_notes.conf
# Configuration file for update_release_notes
# update_release_notes is expected to run automatically and
# - fetch multiple release-notes packages from OBS
# - copy and extract the packages into a given directory
# - generate an index.html file as overview
# The configuration file here should help with some basic
# definitions, that might change - depending on the deployment
#
# The file with the list of RPMS
RELEASENOTES_DATA="$BASEDIR/etc/releasenotes"
# The directory to start the extraction of RPMS
RELNOTESDIR="$BASEDIR/release-notes"
# We want a logfile, if something goes wrong
LOGFILE="$BASEDIR/var/log/$(basename $0).log"
Updated by lkocman over 1 year ago
Making sure to not erase anything server-side
lkocman@localhost:~/Workspace/opensuse/doc-o-o/doc-config> scp -r relsync@community:/home/relsync/etc .
update_release_notes.conf 100% 642 34.7KB/s 00:00
releasenotes 100% 1340 60.6KB/s 00:00
lkocman@localhost:~/Workspace/opensuse/doc-o-o/doc-config> ls
bin etc
lkocman@localhost:~/Workspace/opensuse/doc-o-o/doc-config>
# add 15.5
lkocman@localhost:~/Workspace/opensuse/doc-o-o/doc-config> tail -1 etc/releasenotes
obs://Documentation:Auto/15.5|openSUSE|Leap/15.5|release-notes-openSUSE-L155|x86_64|
Updated by lkocman over 1 year ago
Now it finally passes
lkocman@localhost:~/Workspace/opensuse/doc-o-o> make set_docs_current_version
test -s /home/lkocman/Workspace/opensuse/doc-o-o/publishusers && source /home/lkocman/Workspace/opensuse/doc-o-o/publishusers; \
if [[ $userdoc ]] && [[ $port ]] && [[ $server ]]; then \
echo "Syncing docs config."; \
rsync -lr -v doc-config/{bin,etc} -e "ssh -p $port" "${userdoc}@${server}":'~' ; \
else \
exit 1; \
fi
Syncing docs config.
sending incremental file list
bin/set_current_version
etc/releasenotes
etc/update_release_notes.conf
sent 1,048 bytes received 105 bytes 2,306.00 bytes/sec
total size is 2,491 speedup is 2.16
test -s /home/lkocman/Workspace/opensuse/doc-o-o/publishusers && source /home/lkocman/Workspace/opensuse/doc-o-o/publishusers; \
if [[ $userrn ]] && [[ $port ]] && [[ $server ]] && [[ $version ]]; then \
ssh -p "$port" "${userdoc}@${server}" "set_current_version $version" ; \
else \
echo "The \"version\" variable is not set. Set it in the \"publishusers\" file."; exit 1; \
fi
Setting the current version to 15.5.
~/doc.opensuse.org/htdocs/documentation/leap ~
~
lkocman@localhost:~/Workspace/opensuse/doc-o-o>
Updated by cboltz over 1 year ago
lkocman wrote:
I suppose that these files should be also under git
relsync@community:~> cat etc/releasenotes
Not those on community.i.o.o ;-) - they are only there for historical reasons, and ununsed.
Nowadays the release notes live on pinot.o.o.
Updated by lkocman over 1 year ago
most issues are blocked on https://progress.opensuse.org/issues/130661
Updated by cboltz over 1 year ago
lkocman wrote:
most issues are blocked on https://progress.opensuse.org/issues/130661
That's unblocked since an hour.
Please also have a look at https://progress.opensuse.org/issues/130664 (wrong PDF link/filename on doc.o.o)