Skip to content

Commit 446c361

Browse files
vvolklMarko Petric
authored andcommitted
Fix typos and formatting in Readme
Fix typos and formatting in Readme
1 parent 983c8aa commit 446c361

File tree

2 files changed

+30
-30
lines changed

2 files changed

+30
-30
lines changed

README.md

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@
44
This GitHub Action sets up CernVM-FS for use in GitHub Workflows.
55

66
## Instructions
7-
You can use this GitHub Action in a workflow in your own repository by with `uses: cvmfs-contrib/github-action-cvmfs@main`.
7+
You can use this GitHub Action in a workflow in your own repository with `uses: cvmfs-contrib/github-action-cvmfs@main`.
88

9-
A minimal job examples for the GitHub-hosted runners of type `ubuntu-latest`:
9+
A minimal job example for GitHub-hosted runners of type `ubuntu-latest`:
1010
```yaml
1111
jobs:
1212
ubuntu-minimal:
@@ -16,9 +16,9 @@ jobs:
1616
- name: Test CernVM-FS
1717
run: ls /cvmfs/sft.cern.ch/
1818
```
19-
By default `*.cern.ch, *.egi.eu, *.opensciencegrid.org *.hsf.org` repositories are available
19+
By default `*.cern.ch, *.egi.eu, *.opensciencegrid.org *.hsf.org` repositories are available.
2020

21-
The Action also works with the runners of type `macos-latest`, however in this case it is necessary to specify which repositories you want to mount (via the variable `cvmfs_repositories`), as there is not auto mount for masOS. A minimal example of usage on `macos-latest` is:
21+
The Action also works with runners of type `macos-latest`, however in this case it is necessary to specify which repositories you want to mount (via the variable `cvmfs_repositories`), as there is not auto mount for macOS. A minimal example of usage on `macos-latest` is:
2222
```yaml
2323
jobs:
2424
macOS-minimal:
@@ -30,7 +30,7 @@ jobs:
3030
- name: Test CernVM-FS
3131
run: ls /Users/Shared/cvmfs/sft.cern.ch/
3232
```
33-
Beware that because the runner cannot be rebooted in the macOS case and the repositories are mounted under `/Users/Shared/cvmfs/`
33+
Beware that because the runner cannot be rebooted in the macOS case, the repositories are mounted under `/Users/Shared/cvmfs/`
3434

3535
## Optional Parameters
3636
The following parameters are supported:
@@ -45,12 +45,12 @@ The following parameters are supported:
4545
- `cvmfs_catalog_watermark`: Try to release pinned catalogs when their number surpasses the given watermark. Defaults to 1/4 CVMFS_NFILES; explicitly set by shrinkwrap.
4646
- `cvmfs_check_permissions`: If set to no, disable checking of file ownership and permissions (open all files).
4747
- `cvmfs_claim_ownership`: If set to yes, allows CernVM-FS to claim ownership of files and directories.
48-
- `cvmfs_client_profile`: Choose a suitable proxy automatically is set to single.
48+
- `cvmfs_client_profile`: Chooses a suitable proxy automatically if set to `single`.
4949
- `cvmfs_config_repo_required`: If set to yes, no repository can be mounted unless the config repository is available.
5050
- `cvmfs_debuglog`: If set, run CernVM-FS in debug mode and write a verbose log the the specified file.
5151
- `cvmfs_default_domain`: The default domain will be automatically appended to repository names when given without a domain.
52-
- `cvmfs_dns_max_ttl`: Maximum effective TTL in seconds for DNS queries of proxy server names(not Stratum 1s). Defaults to 1 day.
53-
- `cvmfs_dns_min_ttl`: Minimum effective TTL in seconds for DNS queries of proxy server names (not Stratum 1s). Defaults to 1 minute.
52+
- `cvmfs_dns_max_ttl`: Maximum effective TTL in seconds for DNS queries of proxy server names(not Stratum 1's). Defaults to 1 day.
53+
- `cvmfs_dns_min_ttl`: Minimum effective TTL in seconds for DNS queries of proxy server names (not Stratum 1's). Defaults to 1 minute.
5454
- `cvmfs_dns_retries`: Number of retries when resolving proxy names.
5555
- `cvmfs_dns_roaming`: If true, watch /etc/resolv.conf for nameserver changes.
5656
- `cvmfs_dns_timeout`: Timeout in seconds when resolving proxy names.
@@ -64,60 +64,60 @@ The following parameters are supported:
6464
- `cvmfs_follow_redirects`: When set to yes, follow up to 4 HTTP redirects in requests.
6565
- `cvmfs_hide_magic_xattrs`: If set to yes the client will not expose CernVM-FS specific extended attributes.
6666
- `cvmfs_host_reset_after`: See CVMFS_PROXY_RESET_AFTER.
67-
- `cvmfs_http_proxy`: Chain of HTTP proxy groups used by CernVM-FS. Necessary.Set to DIRECT if you don’t use proxies.
67+
- `cvmfs_http_proxy`: Chain of HTTP proxy groups used by CernVM-FS. Set to DIRECT if you don’t use proxies.
6868
- `cvmfs_ignore_signature`: When set to yes, don’t verify CernVM-FS file catalog signatures.
6969
- `cvmfs_initial_generation`: Initial inode generation. Used for testing.
7070
- `cvmfs_instrument_fuse`: When set to true gather performance statistics about the FUSE callbacks. The results are displayed with cvmfs_talk internal affairs.
7171
- `cvmfs_ipfamily_prefer`: Which IP protocol to prefer when connecting to proxies. Can be either 4 or 6.
7272
- `cvmfs_kcache_timeout`: Timeout for path names and file attributes in the kernel file system buffers.
73-
- `cvmfs_keys_dir`: Directory containing *.pub files used as repository signing keys. If set, this parameter has precedence over CVMFS_PUBLIC_KEY.
73+
- `cvmfs_keys_dir`: Directory containing `*.pub` files used as repository signing keys. If set, this parameter has precedence over CVMFS_PUBLIC_KEY.
7474
- `cvmfs_low_speed_limit`: Minimum transfer rate a server or proxy must provide.
7575
- `cvmfs_max_external_servers`: Limit the number of (geo sorted) stratum 1 servers for external data that are effectively used.
7676
- `cvmfs_max_ipaddr_per_proxy`: Limit the number of IP addresses a proxy names resolves into. From all registered addresses, up to the limit are randomly selected.
7777
- `cvmfs_max_retries`: Maximum number of retries for a given proxy/host combination.
7878
- `cvmfs_max_servers`: Limit the number of (geo sorted) stratum 1 servers that are effectively used.
7979
- `cvmfs_max_ttl`: Maximum file catalog TTL in minutes. Can overwrite the TTL stored in the catalog.
8080
- `cvmfs_memcache_size`: Size of the CernVM-FS meta-data memory cache in Megabyte.
81-
- `cvmfs_mount_rw`: Mount CernVM-FS as a read/write file system. Write operations will fail but this option can workaround faulty open() flags.
81+
- `cvmfs_mount_rw`: Mount CernVM-FS as a read/write file system. Write operations will fail but this option can workaround faulty `open()` flags.
8282
- `cvmfs_nfiles`: Maximum number of open file descriptors that can be used by the CernVM-FS process.
8383
- `cvmfs_nfs_interleaved_inodes`: In NFS mode, use only inodes of the form an+b, specified as “b%a”.
84-
- `cvmfs_nfs_shared`: If set a path, used to store the NFS maps in an SQlite database, instead of the usual LevelDB storage in the cache directory.
84+
- `cvmfs_nfs_shared`: If set, used to store the NFS maps in an SQlite database, instead of the usual LevelDB storage in the cache directory.
8585
- `cvmfs_nfs_source`: If set to yes, act as a source for the NFS daemon (NFS export).
86-
- `cvmfs_oom_score_adj`: Set the Linux kernel’s out-of-memory killer priority for the CernVM-FS client [-1000 - 1000].
86+
- `cvmfs_oom_score_adj`: Set the Linux kernel’s out-of-memory killer priority for the CernVM-FS client `[-1000 - 1000]`.
8787
- `cvmfs_pac_urls`: Chain of URLs pointing to PAC files with HTTP proxy configuration information.
8888
- `cvmfs_proxy_reset_after`: Delay in seconds after which CernVM-FS will retry the primary proxy group in case of a fail-over to another group.
8989
- `cvmfs_proxy_template`: Overwrite the default proxy template in Geo-API calls. Only needed for debugging.
9090
- `cvmfs_public_key`: Colon-separated list of repository signing keys.
91-
- `cvmfs_quota_limit`: Soft-limit of the cache in Megabyte.
91+
- `cvmfs_quota_limit`: Soft-limit of the cache in Megabytes.
9292
- `cvmfs_reload_sockets`: Directory of the sockets used by the CernVM-FS loader to trigger hotpatching/reloading.
93-
- `cvmfs_repositories`: Comma-separated list of fully qualified repository names that shall be mountable under /cvmfs.
94-
- `cvmfs_repository_date`: A timestamp in ISO format (e.g. 2007-03-01T13:00:00Z). Selects the repository state as of the given date.
93+
- `cvmfs_repositories`: Comma-separated list of fully qualified repository names that shall be mountable under `/cvmfs`.
94+
- `cvmfs_repository_date`: A timestamp in ISO format (e.g. `2007-03-01T13:00:00Z`). Selects the repository state as of the given date.
9595
- `cvmfs_repository_tag`: Select a named repository snapshot that should be mounted instead of trunk.
96-
- `cvmfs_root_hash`: Hash of the root file catalog, implies CVMFS_AUTO_UPDATE=no.
96+
- `cvmfs_root_hash`: Hash of the root file catalog, implies `CVMFS_AUTO_UPDATE=no`.
9797
- `cvmfs_send_info_header`: If set to yes, include the cvmfs path of downloaded data in HTTP headers.
9898
- `cvmfs_server_cache_mode`: Enable special cache semantics for a client used as a publisher’s repository base line.
99-
- `cvmfs_server_url`: Semicolon-separated chain of Stratum~1 servers.
99+
- `cvmfs_server_url`: Semicolon-separated chain of Stratum 1 servers.
100100
- `cvmfs_shared_cache`: If set to no, makes a repository use an exclusive cache.
101-
- `cvmfs_strict_mount`: If set to yes, mount only repositories that are listed in CVMFS_REPOSITORIES.
101+
- `cvmfs_strict_mount`: If set to yes, mount only repositories that are listed in `CVMFS_REPOSITORIES`.
102102
- `cvmfs_suid`: If set to yes, enable suid magic on the mounted repository. Requires mounting as root.
103-
- `cvmfs_syslog_facility`: If set to a number between 0 and 7, uses the corresponding LOCAL$n$ facility for syslog messages.
104-
- `cvmfs_syslog_level`: If set to 1 or 2, sets the syslog level for CernVM-FS messages to LOG_DEBUG or LOG_INFO respectively.
103+
- `cvmfs_syslog_facility`: If set to a number `n` between 0 and 7, uses the corresponding `LOCALn` facility for syslog messages.
104+
- `cvmfs_syslog_level`: If set to 1 or 2, sets the syslog level for CernVM-FS messages to `LOG_DEBUG` or `LOG_INFO` respectively.
105105
- `cvmfs_systemd_nokill`: If set to yes, modify the command line to `@vmfs2` ... in order to act as a systemd lowlevel storage manager.
106106
- `cvmfs_timeout`: Timeout in seconds for HTTP requests with a proxy server.
107107
- `cvmfs_timeout_direct`: Timeout in seconds for HTTP requests without a proxy server.
108108
- `cvmfs_tracefile`: If set, enables the tracer and trace file system calls to the given file.
109-
- `cvmfs_use_cdn`: Change the stratum 1 endpoints to caching servers from Cloudflare.
109+
- `cvmfs_use_cdn`: Change the Stratum 1 endpoints to caching servers from Cloudflare.
110110
- `cvmfs_use_geoapi`: Request order of Stratum 1 servers and fallback proxies via Geo-API.
111111
- `cvmfs_user`: Sets the gid and uid mount options. Don’t touch or overwrite.
112-
- `cvmfs_usyslog`: All messages that normally are logged to syslog are re-directed to the given file. This file can grow up to 500kB and there is one step of log rotation. Required for $mu$CernVM.
112+
- `cvmfs_usyslog`: All messages that are normally logged to syslog are re-directed to the given file. This file can grow up to 500kB and there is one step of log rotation. Required for $mu$CernVM.
113113
- `cvmfs_workspace`: Set the local directory for storing special files (defaults to the cache directory).
114114
- `cvmfs_ubuntu_deb_location`: Location from where to download the Ubuntu deb package of CernVM-FS.
115115
- `cvmfs_macos_pkg_location`: Location from where to download the masOS pkg package of CernVM-FS.
116116
- `cvmfs_config_package`: URL to the cvmfs config package to install.
117117
- `run_local_checkout`: Run the local checkout of the action and not the main repo code. Only used for testing and development of this action (needed in CI).
118118

119119
# Optional Parameters Defaults
120-
All optional parameters are set to default to `''`(empty string). All variables that are set to this value are not propagated to `default.local`. The only exception to this are the following variables set to particular defaults:
120+
All optional parameters are set by default to `''`(empty string). All variables that are set to this value are not propagated to `default.local`. The only exception to this are the following variables set to particular defaults:
121121
- `cvmfs_quota_limit`: `'15000'` (see [GitHub Runner Hardware](https://docs.github.com/en/free-pro-team@latest/actions/reference/specifications-for-github-hosted-runners#supported-runners-and-hardware-resources) before changing)
122122
- `cvmfs_client_profile`: `'single'`
123123
- `cvmfs_use_cdn`: `'yes'`
@@ -127,7 +127,7 @@ All optional parameters are set to default to `''`(empty string). All variables
127127

128128
## Minimal Example
129129

130-
The following minimal example, which is also a workflow in this repository at [.github/workflows/minimal-usage.yml](https://github.com/cvmfs-contrib/github-action-cvmfs/tree/main/.github/workflows/minimal-usage.yml), setups up CernVM-FS and lists the contents of the selected repositories from `*.cern.ch, *.egi.eu, *.opensciencegrid.org *.hsf.org`.
130+
The following minimal example, which is also a workflow in this repository at [.github/workflows/minimal-usage.yml](https://github.com/cvmfs-contrib/github-action-cvmfs/tree/main/.github/workflows/minimal-usage.yml), sets up CernVM-FS and lists the contents of the selected repositories from `*.cern.ch, *.egi.eu, *.opensciencegrid.org *.hsf.org`.
131131
```yaml
132132
name: Minimal usage
133133
on: [push, pull_request]
@@ -147,11 +147,11 @@ jobs:
147147

148148
## What Does This Action Do?
149149

150-
This GitHub Action installs the [CernVM-FS package](https://cernvm.cern.ch/fs/#download), and configures it with the `CVMFS_CLIENT_PROFILE='signle'` and `CVMFS_USE_CDN='yes'` to avoid any overhead on the CernVM-FS stratum 1 servers that you are accessing, this GitHub Action uses the [OpenHTC](https://openhtc.io) caching edge servers.
150+
This GitHub Action installs the [CernVM-FS package](https://cernvm.cern.ch/fs/#download), and configures it with the `CVMFS_CLIENT_PROFILE='single'` and `CVMFS_USE_CDN='yes'` to avoid any overhead on the CernVM-FS stratum 1 servers that you are accessing, this GitHub Action uses the [OpenHTC](https://openhtc.io) caching edge servers.
151151

152152
## Limitations
153153

154-
This GitHub Action is only expected to work in workflows that [run on](https://docs.github.com/en/free-pro-team@latest/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on) ubuntu nad macOS targets (and even then likely only `ubuntu-latest`). This exludes the `windows` targets.
154+
This GitHub Action is only expected to work in workflows that [run on](https://docs.github.com/en/free-pro-team@latest/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on) ubuntu and macOS targets (and even then likely only `ubuntu-latest`). This exludes the `windows` targets.
155155

156156
## Use With Docker
157157

action.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ inputs:
4949
required: false
5050
default: ''
5151
cvmfs_client_profile:
52-
description: 'Choose a suitable proxy automatically is set to single'
52+
description: 'Choose a suitable proxy automatically if set to single.'
5353
required: false
5454
default: 'single'
5555
cvmfs_config_repo_required:
@@ -177,7 +177,7 @@ inputs:
177177
required: false
178178
default: ''
179179
cvmfs_memcache_size:
180-
description: 'Size of the CernVM-FS meta-data memory cache in Megabyte.'
180+
description: 'Size of the CernVM-FS meta-data memory cache in Megabytes.'
181181
required: false
182182
default: ''
183183
cvmfs_mount_rw:
@@ -193,7 +193,7 @@ inputs:
193193
required: false
194194
default: ''
195195
cvmfs_nfs_shared:
196-
description: 'If set a path, used to store the NFS maps in an SQlite database, instead of the usual LevelDB storage in the cache directory.'
196+
description: 'If set to a path, used to store the NFS maps in an SQlite database, instead of the usual LevelDB storage in the cache directory.'
197197
required: false
198198
default: ''
199199
cvmfs_nfs_source:

0 commit comments

Comments
 (0)