Skip to content

Commit af94c83

Browse files
committed
Added intersphinx links to Juju (James did some in canonical#1574 too)
1 parent f08d83e commit af94c83

File tree

6 files changed

+7
-7
lines changed

6 files changed

+7
-7
lines changed

docs/howto/get-started-with-charm-testing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -167,7 +167,7 @@ def test_pebble_ready_writes_config_file():
167167
## Integration testing
168168

169169
Where unit testing focuses on black-box method-by-method verification, integration testing focuses on the big picture. Typically integration tests check that the charm does not break (generally this means: blocks with status `blocked` or `error`) when a (mocked) cloud admin performs certain operations. These operations are scripted by using, in order of abstraction:
170-
- shell commands against [the `juju` cli](https://juju.is/docs/olm/juju-cli-commands)
170+
- shell commands against [the `juju` CLI](inv:juju:std:label#list-of-juju-cli-commands)
171171
- [`python-libjuju`](https://github.com/juju/python-libjuju), wrapping juju api calls
172172
- [`pytest-operator`](https://github.com/charmed-kubernetes/pytest-operator), a `pytest` plugin wrapping `python-libjuju`
173173
- [`zaza`](https://zaza.readthedocs.io/en/latest/index.html), a testing-framework-agnostic wrapper on top of `python-libjuju`

docs/howto/manage-leadership-changes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ def _on_leader_elected(self, event: ops.LeaderElectedEvent):
2525
2626
To have the leader notify other units about leadership changes, change data in a peer relation.
2727

28-
> See more: [Peer Relations](https://juju.is/docs/juju/relation#heading--peer)
28+
> See more: {external+juju:ref}`Juju | Peer relations <relation>`
2929
3030
[note status="Use the peer relation rather than `leader-setting-changed`"]
3131
In the past, this was done by observing a `leader-setting-changed` event, which is now deprecated.

docs/howto/manage-logs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ class HelloOperatorCharm(ops.CharmBase):
3535
> - [`logging.getLogger().info()`](https://docs.python.org/3/library/logging.html#logging.Logger.info)
3636
> - [`logging.getLogger().debug()`](https://docs.python.org/3/library/logging.html#logging.Logger.debug)
3737
38-
Juju automatically picks up logs from charm code that uses the Python [logging facility](https://docs.python.org/3/library/logging.html), so we can use the Juju [`debug-log` command](https://juju.is/docs/juju/juju-debug-log) to display logs for a model. Note that it shows logs from the charm code (charm container), but not the workload container. Read ["Use `juju debug-log`"](https://juju.is/docs/sdk/get-logs-from-a-kubernetes-charm#heading--use-juju-debug-log) for more information.
38+
Juju automatically picks up logs from charm code that uses the Python [logging facility](https://docs.python.org/3/library/logging.html), so we can use the Juju [`debug-log` command](inv:juju:std:label#command-juju-debug-log) to display logs for a model. Note that it shows logs from the charm code (charm container), but not the workload container.
3939

4040
Besides logs, `stderr` is also captured by Juju. So, if a charm generates a warning, it will also end up in Juju's debug log. This behaviour is consistent between K8s charms and machine charms.
4141

docs/howto/manage-relations.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ requires:
5959

6060
Other than this, implement a subordinate relation in the same way as any other relation. Note however that subordinate units cannot see each other's peer data.
6161

62-
> See also: [Charm taxonomy](https://juju.is/docs/sdk/charm-taxonomy#heading--subordinate-charms)
62+
> See also: {external+juju:ref}`Juju | Charm taxonomy <charm-taxonomy>`
6363

6464
### Add code to use a relation
6565

@@ -123,7 +123,7 @@ To use data received through the relation, have your charm observe the `relation
123123
framework.observe(self.on.replicas_relation_changed, self._update_configuration)
124124
```
125125

126-
> See more: [](ops.RelationChangedEvent), [`juju` | Relation (integration)](https://juju.is/docs/juju/relation#heading--permissions-around-relation-databags)
126+
> See more: [](ops.RelationChangedEvent), {external+juju:ref}`Juju | Relation (integration) <relation>`
127127

128128
Most of the time, you should use the same holistic handler as when receiving other data, such as `secret-changed` and `config-changed`. To access the relation(s) in your holistic handler, use the [](ops.Model.get_relation) method or [](ops.Model.relations) attribute.
129129

docs/tutorial/from-zero-to-hero-write-your-first-kubernetes-charm/set-up-your-development-environment.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ You will need a charm directory, the various tools in the charm SDK, Juju, and a
1111

1212
You can get all of this by following our generic development setup guide, with some annotations.
1313

14-
> See [Set up / tear down automatically](https://juju.is/docs/juju/set-up--tear-down-your-test-environment#set-up-tear-down-automatically), with the following changes:
14+
> See the automatic setup instructions in {external+juju:ref}`Juju | Manage your deployment environment <manage-your-deployment-environment>`, with the following changes:
1515
> - At the directory step, call your directory `fastapi-demo`.
1616
> - At the VM setup step, call your VM `charm-dev` and also set up Docker:
1717
> 1. `sudo addgroup --system docker`

docs/tutorial/write-your-first-machine-charm.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -522,7 +522,7 @@ Congratulations, your charm user can view the version of the workload deployed f
522522

523523
## Tear things down
524524

525-
> See [Juju | Tear down your development environment automatically](https://juju.is/docs/juju/set-up--tear-down-your-test-environment#tear-down-automatically)
525+
> See the automatic teardown instructions in {external+juju:ref}`Juju | Manage your deployment environment <manage-your-deployment-environment>`.
526526

527527

528528

0 commit comments

Comments
 (0)