mirror of
https://github.com/LCTT/TranslateProject.git
synced 2025-03-21 02:10:11 +08:00
Merge remote-tracking branch 'LCTT/master'
This commit is contained in:
Xingyu Wang
commit
f9ac0e5df3
@ -1,5 +1,5 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: ( )
|
||||
[#]: translator: (sthwhl)
|
||||
[#]: reviewer: ( )
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
|
||||
@ -1,148 +0,0 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: ( )
|
||||
[#]: reviewer: ( )
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
[#]: subject: (4 lines of code to improve your Ansible play)
|
||||
[#]: via: (https://opensource.com/article/21/1/improve-ansible-play)
|
||||
[#]: author: (Jeff Warncia https://opensource.com/users/jeffwarncia)
|
||||
|
||||
4 lines of code to improve your Ansible play
|
||||
======
|
||||
With a tiny bit of effort, you can help the next person by not just
|
||||
mapping the safe path but leaving warnings about the dangers.
|
||||
![A person programming][1]
|
||||
|
||||
Out in the blogosphere, which sings the virtues of infrastructure-as-code, continuous integration/continuous delivery (CI/CD) pipelines, code reviews, and testing regimes, it is easy to forget that such a well-engineered ivory tower is an ideal, not a reality. Imperfect systems haunt us, but we must ship something.
|
||||
|
||||
There are few towers less ivory than those created by gluing together APIs in the course of system automation. It is a brittle world. The pressures are enormous to get it "working," get it shipped, and move on.
|
||||
|
||||
### A problem to solve
|
||||
|
||||
Imagine a simple feature request: Write some [Ansible][2] code to create several records in an external system to record some details of a VLAN. I recently had an itch to do some lab administration work to fulfill this task. The external system is a well-known internet protocol address management (IPAM) tool, but the roadblocks are the same for a more abstract configuration management database (CMDB) or a record unrelated to networking. In this example, my immediate desire for creating a record is that alone—the system is only for record-keeping.
|
||||
|
||||
If the goal was a hyper-compact, straightforward, and dumb macro, it might work out to be 100 lines of code. If I had the API memorized, I might be able to bang it out in an hour, with the code doing nothing more than expected and leaving nothing but the exact, finished artifact behind. Exactly perfect for its purpose and entirely useless for any future expansion.
|
||||
|
||||
Nowadays, I'd expect almost everyone to start this task with a role and several task files, prepared to expand to what will be a dozen or so create, read, update, and delete (CRUD) operations. Because I'm not one of the people who know this API, I may spend between several hours and several days just fooling around with it, figuring out its internal patterns and craftsmanship, bridging the gap between its capabilities and my desires encoded in the code.
|
||||
|
||||
While researching the API, I discovered that creating a VLAN record requires a parent object _reference_. This looks something like a path fragment with random characters in it. Maybe it's a hash, or maybe it really is random; I don't know. I imagine that many down in the mud with a looming deadline might just copy and paste this arbitrary string into Ansible and move on with their lives. Ignoring the implementation details of the role, the obvious play-level task would be:
|
||||
|
||||
|
||||
```
|
||||
\- name: "Create VLAN"
|
||||
include_role:
|
||||
name: otherthing
|
||||
tasks_from: vlan_create.yml
|
||||
vars:
|
||||
vlan_name: "lab-infra"
|
||||
vlan_tag: 100
|
||||
vlan_view_ref: "vlan_view/747f602d-0381"
|
||||
```
|
||||
|
||||
Unfortunately, that `vlan_view_ref` identifier isn't available except via the API, so even moving it to an inventory or extra variable doesn't help very much. The playbook's user would need to have some unusual level of understanding of the system to find out the correct reference ID.
|
||||
|
||||
In my lab-building situation, I will redeploy this system of record frequently. Therefore, the parent ID will change from day to day, and I don't want to have to figure it out manually each time. So I definitely must search for the reference by name. No problem:
|
||||
|
||||
|
||||
```
|
||||
\- name: Get Lab vlan view reference
|
||||
include_role:
|
||||
name: otherthing
|
||||
tasks_from: search_for.yml
|
||||
vars:
|
||||
_resource: vlan_view
|
||||
_query: "name={{ vlan_parent_view_name }}"
|
||||
```
|
||||
|
||||
Ultimately, it makes a REST call. This "returns" JSON, which I stuff into `_otherthing_search_result` by convention and for ease of access outside the role. The `search_for.yml` implementation is abstract, and it always returns a dict of zero or more results.
|
||||
|
||||
Most Ansible developers, as evidenced by nearly all the real-world Ansible code I've ever read, would proceed as if all is great and directly access the expected single result:
|
||||
|
||||
|
||||
```
|
||||
\- name: Remember our default vlan view ref
|
||||
set_fact:
|
||||
_thatthig_vlan_view_ref: "{{ _otherthing_search_result[0]._ref }}"
|
||||
|
||||
\- name: "Create VLAN"
|
||||
include_role:
|
||||
name: otherthing
|
||||
tasks_from: vlan_create.yml
|
||||
vars:
|
||||
vlan_name: "lab-infra"
|
||||
vlan_tag: 100
|
||||
vlan_view_ref: "{{ vlan_parent_view_name }}"
|
||||
```
|
||||
|
||||
But sometimes `_thatthing_search_result[0]` will be undefined, so `_thatthig_vlan_view_ref` will be undefined. Most likely, this is because the code ran in a different real-world environment and someone forgot to update `{{ vlan_parent_view_name }}` either in the inventory or from the command line. Or, fair or foul, maybe someone went into the tool's graphical user interface (GUI) and deleted the record or changed its name or something.
|
||||
|
||||
I know what you're thinking.
|
||||
|
||||
_"Well, don't do that. This is a no dumb venue. Be less dumb."_
|
||||
|
||||
Maybe I am OK with this situation and retort: "Ansible will tell you quite correctly `The error was: list object has no element 0` and even cough up a line number. What more do you want?" As the developer, of course, I know what that means—I just wrote it. I just came off three days of fooling around with the API. My mind is fresh.
|
||||
|
||||
### Tomorrow is another story
|
||||
|
||||
But by tomorrow, I'll probably forget what a vlan view reference is, and I'll definitely forget what is on line 30. If it goes wrong in a month, even if you manage to find me, I'll have to take an afternoon to decode the API guide again to figure out what went wrong.
|
||||
|
||||
And what if I'm out the door? What if I've turned the code over to an operations team, maybe an intern running it through [Tower][3], hand-feeding `vlan_view_name` into a survey or such? That line 30 is the problem is of no help to them.
|
||||
|
||||
Add comments, you say! Well, yes. I could write some terse prose in the code to help the developer next week or next month. This does not help the person running the code and whose job just failed, and it certainly doesn't help the business get done whatever it needs done.
|
||||
|
||||
Remember, we are all-powerful in the moment. In writing code or skipping writing code, we do it from a position of strength and knowledge. We have taken hours, or even days, assimilating the documentation, the reality, the other bugs, the other problems, and we have left behind code, comments, and maybe even documentation. We write code that shares that success, and success is what our users want. But there was a lot of failure in that learning; we can leave that behind, too.
|
||||
|
||||
### Leave a message in code
|
||||
|
||||
`Error on line 30` helps no one. At the absolute minimum, I can handle the obvious error case with a better error message:
|
||||
|
||||
|
||||
```
|
||||
- name: Fail if zero vlan views returned
|
||||
fail:
|
||||
msg: "Got 0 results from searching for VLAN view {{ vlan_parent_view_name }}. Please verify exists in otherthing, and is accessible by the service account."
|
||||
when: _otherthing_search_result | length == 0
|
||||
```
|
||||
|
||||
In four lines of code (and zero additional thinking), I have specific, helpful advice to whoever comes next—that hapless operations team member, or more likely me in a month—about the real-world problem that really isn't about the code at all. This message allows anyone to discover a simple copy/paste error or that the system of record changed. No Ansible knowledge needed, no 3am page to a developer to "look at line 30."
|
||||
|
||||
But wait! There's more!
|
||||
|
||||
In learning about `otherthing`, I learned it was, well, kinda dumb in one critical respect. Many, if not all, of its record types have no uniqueness constraint, and several identical records may exist. A vlan view is defined as having a name, a start ID, and an end ID; other record types are similarly simple and obviously should be a unique tuple—based both on reality and the abstract concept of database normalization. But `otherthing` allows duplicate tuples, despite it never conceptually being possible.
|
||||
|
||||
In my lab, I'm happy enough to try and remember not to do that. In a corporate production environment, I might write a policy. Either way, experience tells me that the system will get corrupted, it will get corrupted at a bad time, and it might take a long time for these problems to become, well, a problem.
|
||||
|
||||
With `Error on line 30`, an otherwise reasonably experienced Ansible developer might recognize that as being "record not found" without knowing anything else, and this would be enough to fix the problem. But it's much, much worse to have `_thatthing_search_result[0]` only sometimes the correct `vlan_view_ref`—it allows the world to be broken, silently. And the error may manifest itself somewhere else entirely; perhaps a security audit six months from now will flag this as inconsistent record-keeping, and if there are several tools and manual access, it might take days or weeks to track down the fact that this particular code was at fault.
|
||||
|
||||
In several days of fumbling around with the API, I learned this. I wasn't looking for problems; if it was documented, I did not see it. So I come to the point of this essay. Rather than dismiss this impossible situation as being because its a lab, fixing it, and moving on, I took two minutes to leave behind _code_—not a comment, not a mental note, not documentation—but code that will always run, that covers this impossible situation:
|
||||
|
||||
|
||||
```
|
||||
- name: Fail if >1 views returned
|
||||
fail:
|
||||
msg: "Got {{ _otherthing_search_result | length }} results from searching for VLAN view {{ vlan_parent_view_name }}. Otherthing allows this, but is not handled by this code."
|
||||
when: _otherthing_search_result | length > 1
|
||||
```
|
||||
|
||||
I manually created the failure condition, so I could manually test this condition. I hope it will never run in real-world use, but I am confident it will.
|
||||
|
||||
If (when) that error happens in production, then someone can decide what to do. I'd expect them to fix the bad data. If it happens a lot, I'd hope they would track down the other broken system. If they demand this code be removed, and this code does the undefined and wrong thing, that is their prerogative and a place where I don't want to work. The code is imperfect, but it is complete. The work of a craftsman.
|
||||
|
||||
Automation in the real world is an iterative process that fights with and uses imperfect systems equally. It will never handle all the exceptional situations. It might not even handle all the normal situations. Working code that passes lint, code reviews, and acceptance tests is code that handles the safe and needed path. With a tiny bit of effort, you can help out the next person by not just mapping the safe path but leaving behind warnings to the dangers you found.
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/21/1/improve-ansible-play
|
||||
|
||||
作者：[Jeff Warncia][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[译者ID](https://github.com/译者ID)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://opensource.com/users/jeffwarncia
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/computer_keyboard_laptop_development_code_woman.png?itok=vbYz6jjb (A person programming)
|
||||
[2]: https://www.ansible.com/
|
||||
[3]: https://www.ansible.com/products/tower
|
||||
@ -1,152 +0,0 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: ( )
|
||||
[#]: reviewer: ( )
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
[#]: subject: (Learn C by writing a simple game)
|
||||
[#]: via: (https://opensource.com/article/21/1/learn-c)
|
||||
[#]: author: (Jim Hall https://opensource.com/users/jim-hall)
|
||||
|
||||
Learn C by writing a simple game
|
||||
======
|
||||
This "guess the number" game is a great introductory program when
|
||||
learning a new programming language. Here's how to write it in C.
|
||||
![Business woman on laptop sitting in front of window][1]
|
||||
|
||||
I [taught myself about programming][2] back in elementary school. My first programs were on the Apple II, but eventually, I learned C by reading books and practicing. And the best way to practice programming is to write sample programs that help exercise your new knowledge.
|
||||
|
||||
One program I like to write in a new language is a simple "guess the number" game. The computer picks a random number from 1 to 100, and you have to figure it out by making guesses. In another article, I showed how to write this ["Guess the number" game in Bash][3], and my fellow Opensource.com authors have written articles about how to write it in [Java][4], [Julia][5], and other computer languages.
|
||||
|
||||
What's great about a "Guess the number" game is that it exercises several programming concepts: how to use variables, how to compare values, how to print output, and how to read input.
|
||||
|
||||
Over the summer, I recorded [a video series][6] to teach people how to write programs in the [C programming language][7]. Since then, I've heard from many people who are learning C programming by following it. So, I thought I'd follow up by writing a "Guess the number" game in C.
|
||||
|
||||
### Pick a random number
|
||||
|
||||
Start the "Guess the number" game by writing a function to pick a random number. When writing functions, good programmers try to make them flexible, so they can reuse them to solve slightly different problems. So, instead of hard-coding the function to pick a random number between 1 and 100, write the function to pick a random number between 1 and some integer value `maxval`:
|
||||
|
||||
|
||||
```
|
||||
#include <stdio.h>
|
||||
#include <sys/random.h>
|
||||
|
||||
int
|
||||
randnum(int maxval)
|
||||
{
|
||||
/* pick a random number from 1 to maxval */
|
||||
|
||||
int randval;
|
||||
|
||||
getrandom(&randval, sizeof(int), GRND_NONBLOCK);
|
||||
|
||||
/* could be negative, so ensure it's positive */
|
||||
|
||||
if (randval < 0) {
|
||||
return (-1 * randval % maxval + 1);
|
||||
}
|
||||
else {
|
||||
return (randval % maxval + 1);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
The function uses the Linux system call `getrandom` to generate a series of random bits. You can learn more about this system call on the man page, but note that `getrandom` will fill the variable with random zeroes and ones. That means the final value could be positive or negative, so you need to do a test afterward to ensure the result of your `randnum` function is a positive value.
|
||||
|
||||
### Write the program
|
||||
|
||||
You can use this function to write your "Guess the number" program:
|
||||
|
||||
|
||||
```
|
||||
#include <stdio.h>
|
||||
#include <sys/random.h>
|
||||
|
||||
int
|
||||
randnum(int maxval)
|
||||
{
|
||||
...
|
||||
}
|
||||
|
||||
int
|
||||
main(void)
|
||||
{
|
||||
int number;
|
||||
int guess;
|
||||
|
||||
number = randnum(100);
|
||||
|
||||
[puts][8]("Guess a number between 1 and 100");
|
||||
|
||||
do {
|
||||
[scanf][9]("%d", &guess);
|
||||
|
||||
if (guess < number) {
|
||||
[puts][8]("Too low");
|
||||
}
|
||||
else if (guess > number) {
|
||||
[puts][8]("Too high");
|
||||
}
|
||||
} while (guess != number);
|
||||
|
||||
[puts][8]("That's right!");
|
||||
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
|
||||
The program starts by picking a random number between 1 and 100 using the `randnum` function. After printing a prompt to the user, the program enters a `do-while` loop so the user can guess the number.
|
||||
|
||||
In each iteration of the loop, the program tests the user's guess. If the user's guess is less than the random number, the program prints "Too low," and if the guess is greater than the random number, the program prints "Too high." The loop continues until the user's guess is the same as the random number.
|
||||
|
||||
When the loop exits, the program prints "That's right!" and then immediately ends.
|
||||
|
||||
|
||||
```
|
||||
$ gcc -o guess -Wall guess.c
|
||||
|
||||
$ ./guess
|
||||
Guess a number between 1 and 100
|
||||
50
|
||||
Too high
|
||||
30
|
||||
Too low
|
||||
40
|
||||
Too low
|
||||
45
|
||||
Too high
|
||||
42
|
||||
Too low
|
||||
43
|
||||
Too low
|
||||
44
|
||||
That's right!
|
||||
```
|
||||
|
||||
### Try it out
|
||||
|
||||
This "guess the number" game is a great introductory program when learning a new programming language because it exercises several common programming concepts in a pretty straightforward way. By implementing this simple game in different programming languages, you can demonstrate some core concepts and compare details in each language.
|
||||
|
||||
Do you have a favorite programming language? How would you write the "guess the number" game in it? Follow this article series to see examples of other programming languages that might interest you.
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/21/1/learn-c
|
||||
|
||||
作者：[Jim Hall][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[译者ID](https://github.com/译者ID)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://opensource.com/users/jim-hall
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/lenovo-thinkpad-laptop-concentration-focus-windows-office.png?itok=-8E2ihcF (Woman using laptop concentrating)
|
||||
[2]: https://opensource.com/article/20/8/learn-open-source
|
||||
[3]: https://opensource.com/article/20/12/learn-bash
|
||||
[4]: https://opensource.com/article/20/12/learn-java
|
||||
[5]: https://opensource.com/article/20/12/julia
|
||||
[6]: https://opensource.com/article/20/8/teaching-c
|
||||
[7]: https://opensource.com/article/20/8/c-programming-cheat-sheet
|
||||
[8]: http://www.opengroup.org/onlinepubs/009695399/functions/puts.html
|
||||
[9]: http://www.opengroup.org/onlinepubs/009695399/functions/scanf.html
|
||||
@ -0,0 +1,144 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: (wxy)
|
||||
[#]: reviewer: (wxy)
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
[#]: subject: (4 lines of code to improve your Ansible play)
|
||||
[#]: via: (https://opensource.com/article/21/1/improve-ansible-play)
|
||||
[#]: author: (Jeff Warncia https://opensource.com/users/jeffwarncia)
|
||||
|
||||
4 行代码提高你的 Ansible 剧本
|
||||
======
|
||||
|
||||
> 只要付出一点点努力，你就可以帮助下一个人，不只是绘制出安全路径，还可以留下危险的警告。
|
||||
|
||||
![一个人编程][1]
|
||||
|
||||
在博客圈里，人们对基础架构即代码、持续集成/持续交付（CI/CD）管道、代码审查和测试制度赞不绝口，但人们很容易忘记，这种精心设计的象牙塔只是一种理想，而不是现实。虽然不完美的系统困扰着我们，但我们必须交付一些东西。
|
||||
|
||||
在系统自动化的过程中，很少有比那些通过粘合 API 创建的象牙塔更脆弱的塔。这是一个脆弱的世界。要让它“工作起来”，交付它，然后继续前进，压力是巨大的。
|
||||
|
||||
### 要解决的问题
|
||||
|
||||
想象一个简单的功能请求：编写一些 [Ansible][2] 代码，在外部系统中创建几条记录，以记录一个 VLAN 的一些详细信息。我最近很想做一些实验室的管理工作来完成这个任务。这个外部系统是一个常见的<ruby>互联网协议地址管理<rt>Internet Protocol Address Management</rt></ruby>（IPAM）工具，但对于一个更抽象的<ruby>配置管理数据库<rt>Configuration Management DataBase</rt></ruby>（CMDB）或一个与网络无关的记录来说，困难是一样的。在这个例子中，我创建一个记录的直接愿望就是让系统保存记录而已。
|
||||
|
||||
如果我们的目标是一个超紧凑的、直接的、笨拙的宏，那么它可能用 100 行代码就能写出来。如果我记得 API，我也许能在一个小时内把它敲出来，该代码的作用不会超过预期，除了确切的成品之外，什么也没留下。对它的目的而言是完美的，但是对未来的扩展毫无用处。
|
||||
|
||||
如今，我希望几乎每个人都能从一个<ruby>角色<rt>role</rt></ruby>和几个<ruby>任务<rt>task</rt></ruby>文件开始这项任务，准备扩展到十几个创建、读取、更新和删除（CRUD）操作。因为我不了解这个 API，我可能会花上几个小时到几天的时间，仅仅是摆弄它，弄清楚它的内部模式和工艺，弥和它的功能和我用代码编写出来的意图之间的差距。
|
||||
|
||||
在研究 API 的时候，我发现创建一个 VLAN 记录需要一个父对象引用 `vlan_view_ref`。这看起来像一个路径片段，里面有随机字符。也许它是一个哈希，也许它真的是随机的，我不确定。我猜想，许多在泥泞中挣扎的人，在迫在眉睫的截止日期前，可能会把这个任意的字符串复制粘贴到 Ansible 中，然后继续混下去。忽略这个<ruby>角色<rt>role</rt></ruby>的实现细节，显而易见这个<ruby>剧本<rt>playbook</rt></ruby>级的任务应该是这样：
|
||||
|
||||
```
|
||||
- name: "Create VLAN"
|
||||
include_role:
|
||||
name: otherthing
|
||||
tasks_from: vlan_create.yml
|
||||
vars:
|
||||
vlan_name: "lab-infra"
|
||||
vlan_tag: 100
|
||||
vlan_view_ref: "vlan_view/747f602d-0381"
|
||||
```
|
||||
|
||||
不幸的是，除了通过 API，`vlan_view_ref` 标识符是不可用的，所以即使把它移到<ruby>清单文件<rt>inventory</rt></ruby>或额外的变量中也没有什么帮助。<ruby>剧本<rt>playbook</rt></ruby>的用户需要对系统有一些更深入的理解，才能找出正确的引用 ID。
|
||||
|
||||
在实验室建设的情况下，我会经常重新部署这个记录系统。因此，这个父对象引用 ID 每天都会发生变化，我不希望每次都要手动找出它。所以，我肯定要按名称搜索该引用。没问题：
|
||||
|
||||
```
|
||||
- name: Get Lab vlan view reference
|
||||
include_role:
|
||||
name: otherthing
|
||||
tasks_from: search_for.yml
|
||||
vars:
|
||||
_resource: vlan_view
|
||||
_query: "name={{ vlan_parent_view_name }}"
|
||||
```
|
||||
|
||||
最终，它进行了一个 REST 调用。这将“返回” 一个 JSON，按照惯例，为了便于在角色外访问，我把它填充进了`_otherthing_search_result` 中，。`search_for.yml` 的实现是抽象的，它总是返回一个包含零或多个结果的字典。
|
||||
|
||||
正如我读过的几乎所有真实世界的 Ansible 代码所证明的那样，大多数 Ansible 开发者将会继续前进，好像一切都很好，并且可以直接访问预期的单个结果：
|
||||
|
||||
```
|
||||
- name: Remember our default vlan view ref
|
||||
set_fact:
|
||||
_thatthig_vlan_view_ref: "{{ _otherthing_search_result[0]._ref }}"
|
||||
|
||||
- name: "Create VLAN"
|
||||
include_role:
|
||||
name: otherthing
|
||||
tasks_from: vlan_create.yml
|
||||
vars:
|
||||
vlan_name: "lab-infra"
|
||||
vlan_tag: 100
|
||||
vlan_view_ref: "{{ vlan_parent_view_name }}"
|
||||
```
|
||||
|
||||
但有时 `_otherthing_search_result[0]` 是未定义的，所以 `_thatthig_vlan_view_ref` 也将是未定义的。很有可能是因为代码运行在不同的真实环境中，而有人忘记了在清单中或在命令行中更新 `{{ vlan_parent_view_name }}`。或者，无论公平与否，也许有人进入了工具的图形用户界面（GUI），删除了记录或更改了它的名称什么的。
|
||||
|
||||
我知道你在想什么。
|
||||
|
||||
_“好吧，不要这样做。这是一个没有哑巴的场所。不要那么笨。”_。
|
||||
|
||||
也许我对这种情况还算满意，反驳道：“Ansible 会很正确的告诉你`错误是：list 对象没有元素 0`，甚至会带个行号。你还想怎样？”作为开发者，我当然知道这句话的意思 —— 我刚写的代码。我刚从三天的和 API 斗智斗勇中走出来，我的脑子很清醒。
|
||||
|
||||
### 明天是另一个故事
|
||||
|
||||
但是到了明天，我可能会忘记什么是父对象引用，我肯定会忘记第 30 行上的内容。如果一个月后出了问题，就算你能找到我，我也得花一个下午的时间重新解读 API 指南，才能搞清楚到底出了什么问题。
|
||||
|
||||
而如果我出门了呢？如果我把代码交给了一个运维团队，也许是一个实习生通过 [Tower][3] 来运行，把 `vlan_view_name` 手动输入到表单之类的东西呢？那第 30 行出的问题是对他们没有帮助的。
|
||||
|
||||
你说，加注释吧! 嗯，是的。我可以在代码中写一些梗概，以帮助下周或下个月的开发人员。这对运行代码的人没有帮助，他的工作刚刚失败，当然对于企业也无济于事。
|
||||
|
||||
记住，我们此刻无所不能。在写代码或者跳过写代码的时候，我们是站在实力和知识的立场上进行的。我们花了几个小时，甚至几天的时间，研究了文档、现实、其他 bug、其他问题，我们留下了代码、注释，甚至可能还有文档。我们写的代码是分享成功的，而成功正是我们用户想要的。但是在这种学习中也有很多失败的地方，我们也可以留下这些。
|
||||
|
||||
### 在代码中留言
|
||||
|
||||
“第 30 行有错误”对任何人都没有帮助。至少，我可以用更好的错误信息来处理明显的错误情况：
|
||||
|
||||
```
|
||||
- name: Fail if zero vlan views returned
|
||||
fail:
|
||||
msg: "Got 0 results from searching for VLAN view {{ vlan_parent_view_name }}. Please verify exists in otherthing, and is accessible by the service account."
|
||||
when: _otherthing_search_result | length == 0
|
||||
```
|
||||
|
||||
在这四行代码中（没有额外的思考），我把具体的、有用的建议留给了下一个人 —— 那个无助的运维团队成员，或者更有可能是一个月后的我 —— 这是关于现实世界中的问题，其实根本不是关于代码的。这条消息可以让任何人发现一个简单的复制/粘贴错误，或者记录系统发生了变化。不需要 Ansible 知识，不需要凌晨 3 点给开发人员发短信“看看第 30 行”。
|
||||
|
||||
但是等等！还有更多！
|
||||
|
||||
在了解 `otherthing` 的过程中，我了解到它在一个关键的方面，嗯，还挺笨的。它的许多记录类型（如果不是全部的话）没有唯一性约束，可能存在几个相同的记录。VLAN 视图被定义为有一个名称、一个开始 ID 和一个结束 ID；其他记录类型也同样简单，显然这应该是一个唯一的元组 —— 基于现实和数据库规范化的抽象概念。但 `otherthing` 允许重复的元组，尽管在概念上讲永远不可能。
|
||||
|
||||
在我的实验室里，我很乐意尝试并记住不要这样做。在企业生产环境中，我可能会写一个策略。不管是哪种方式，经验告诉我，系统会被破坏，会在倒霉的时候被破坏，而且可能需要很长时间才能让这些问题发酵成，嗯，一个问题。
|
||||
|
||||
对于 “第 30 行有错误”，一个本来有丰富经验的 Ansible 开发者可能会认识到这是“记录没有找到”，而不用知道其他的事情就足以解决这个问题。但如果 `_otherthing_search_result[0]` 只有有时是正确的 `vlan_view_ref`，那就糟糕多了，它让整个世界被破坏，而悄无声息。而这个错误可能完全表现在其他地方，也许六个月后的安全审计会将其标记为记录保存不一致，如果有多种工具和人工访问方式，可能需要几天或几周的时间才能发现这个特定代码出错的事实。
|
||||
|
||||
在几天对 API 的摸索中，我学到了这一点。我不是在找问题，如果有记录，我没有看到。所以我来到了这篇文章的重点。我没有因为它是一个实验室，修复它，然后继续前进而忽略了这种不可能的情况，而是花了两分钟留下了_代码_ —— 不是注释，不是心理笔记，不是文档 —— 而是会一直运行的代码，涵盖了这种不可能的情况：
|
||||
|
||||
```
|
||||
- name: Fail if > 1 views returned
|
||||
fail:
|
||||
msg: "Got {{ _otherthing_search_result | length }} results from searching for VLAN view {{ vlan_parent_view_name }}. Otherthing allows this, but is not handled by this code."
|
||||
when: _otherthing_search_result | length > 1
|
||||
```
|
||||
|
||||
我手动创建了失败条件，所以我可以手动测试这个条件。我希望它永远不会在实际使用中运行，但我觉得它会。
|
||||
|
||||
如果（当）这个错误发生在生产环境中，那么有人可以决定该怎么做。我希望他们能修复坏数据。如果它经常发生，我希望他们能追踪到另一个损坏的系统。如果他们要求删除这段代码，而这段代码做了未定义和错误的事情，那是他们的特权，也是我不想工作的地方。代码是不完美的，但它是完整的。这是匠人的工作。
|
||||
|
||||
现实世界中的自动化是一个迭代的过程，它与不完美的系统进行斗争，并平等地使用。它永远不会处理所有的特殊情况。它甚至可能无法处理所有的正常情况。通过 Lint、代码审查和验收测试的工作代码是处理安全和所需路径的代码。只要付出一点点努力，你就可以帮助下一个人，不仅仅是绘制安全路径，还可以对你发现的危险留下警告。
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/21/1/improve-ansible-play
|
||||
|
||||
作者：[Jeff Warncia][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[wxy](https://github.com/wxy)
|
||||
校对：[wxy](https://github.com/wxy)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://opensource.com/users/jeffwarncia
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/computer_keyboard_laptop_development_code_woman.png?itok=vbYz6jjb (A person programming)
|
||||
[2]: https://www.ansible.com/
|
||||
[3]: https://www.ansible.com/products/tower
|
||||
151
translated/tech/20210106 Learn C by writing a simple game.md
Normal file
151
translated/tech/20210106 Learn C by writing a simple game.md
Normal file
@ -0,0 +1,151 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: (qfzy1233 )
|
||||
[#]: reviewer: ( )
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
[#]: subject: (Learn C by writing a simple game)
|
||||
[#]: via: (https://opensource.com/article/21/1/learn-c)
|
||||
[#]: author: (Jim Hall https://opensource.com/users/jim-hall)
|
||||
|
||||
通过编写一个简单的游戏学习C语言
|
||||
======
|
||||
当你学习一门新的编程语言时，这个“猜数字”游戏是一个很好的入门程序。下面是如何用C语言来编写它。
|
||||
![Business woman on laptop sitting in front of window][1]
|
||||
|
||||
我在小学时就开始 [自学编程][2] 。 我的第一个程序是在Apple II上编写的，但最终，我通过阅读和编程练习来学习C语言。练习编程的最佳方法是编写示例程序，他能帮助你练习新知识。
|
||||
|
||||
在我学习一种新的编程语言时，我喜欢编写一个简单的“猜数字”游戏来练习。电脑从1到100中随机挑选一个数字，你必须通过猜测来算出来。在另一篇文章中，我展示了如何用 Bash 语言编写这个[“猜数字”游戏][3]，我的 Opensource.com 的同伴同事也写了一些文章，介绍如何用[Java][4]、[Julia][5]和其他计算机语言编写它。
|
||||
|
||||
“猜数字”游戏的伟大之处在于它践行了几个编程概念:如何使用变量、如何比较值、如何打印输出以及如何读取输入。
|
||||
|
||||
整个夏天，我录制了[一个系列视频][6]，教人们如何用[C语言][7]编写程序。从那以后，我收到了许多通过学习C语言的订阅观众的来信。所以，我想接着用 C 语言写一个“猜数字”的游戏。
|
||||
|
||||
### 去取一个随机数
|
||||
|
||||
从写一个函数来选择一个随机数字来开始“猜数字”游戏。在编写函数时，优秀的程序员会尽量使它们具有灵活性，这样他们就可以重用它们来解决略有不同的问题。因此，与其硬编码函数来选择1到100之间的一个随机数，不如编写函数来选择1到某个整数' maxval '之间的一个随机数:开始“猜数字”游戏，写一个函数来选择一个随机数字。在编写函数时，优秀的程序员会尽量使它们具有灵活性，这样他们就可以重用它们来解决略有不同的问题。因此，与其硬编码函数来选择1到100之间的一个随机数，不如编写函数来选择1到某个整数' maxval '之间的一个随机数:
|
||||
|
||||
|
||||
```
|
||||
#include <stdio.h>
|
||||
#include <sys/random.h>
|
||||
|
||||
int
|
||||
randnum(int maxval)
|
||||
{
|
||||
/* 从 1 到 maxval 之前取一个随机数 */
|
||||
|
||||
int randval;
|
||||
|
||||
getrandom(&randval, sizeof(int), GRND_NONBLOCK);
|
||||
|
||||
/* 可能是负值，所以要确保改数值为正值 */
|
||||
|
||||
if (randval < 0) {
|
||||
return (-1 * randval % maxval + 1);
|
||||
}
|
||||
else {
|
||||
return (randval % maxval + 1);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
该函数使用 Linux 系统调用 `getrandom` 来生成一系列随机数。你可以在 man 中了解关于这个系统调用的更多信息，但请注意，`getrandom` 将用随机的0和1填充变量。这意味着最终值可以是正的，也可以是负的，因此您需要在之后进行测试，以确保 `randnum` 函数的结果是正值。
|
||||
|
||||
### 编写程序
|
||||
|
||||
你可以用这个函数来写你的“猜数字”程序:
|
||||
|
||||
|
||||
```
|
||||
#include <stdio.h>
|
||||
#include <sys/random.h>
|
||||
|
||||
int
|
||||
randnum(int maxval)
|
||||
{
|
||||
...
|
||||
}
|
||||
|
||||
int
|
||||
main(void)
|
||||
{
|
||||
int number;
|
||||
int guess;
|
||||
|
||||
number = randnum(100);
|
||||
|
||||
[puts][8]("Guess a number between 1 and 100");
|
||||
|
||||
do {
|
||||
[scanf][9]("%d", &guess);
|
||||
|
||||
if (guess < number) {
|
||||
[puts][8]("Too low");
|
||||
}
|
||||
else if (guess > number) {
|
||||
[puts][8]("Too high");
|
||||
}
|
||||
} while (guess != number);
|
||||
|
||||
[puts][8]("That's right!");
|
||||
|
||||
return 0;
|
||||
}
|
||||
```
|
||||
|
||||
程序首先使用 `randnum` 函数从1到100之间选择一个随机数。在向用户输出一个提示后，程序进入一个 `do-while` 循环，以便用户可以猜测数字。
|
||||
|
||||
在循环的每次迭代中，程序测试用户的猜测的数值。如果用户的猜测小于随机数，程序将输出“太低”，如果猜测大于随机数，程序将输出“太高”。循环继续，直到用户的猜测与随机数相同。
|
||||
|
||||
当循环退出时，程序输出“That's right!”，然后立即结束。
|
||||
|
||||
|
||||
```
|
||||
$ gcc -o guess -Wall guess.c
|
||||
|
||||
$ ./guess
|
||||
Guess a number between 1 and 100
|
||||
50
|
||||
Too high
|
||||
30
|
||||
Too low
|
||||
40
|
||||
Too low
|
||||
45
|
||||
Too high
|
||||
42
|
||||
Too low
|
||||
43
|
||||
Too low
|
||||
44
|
||||
That's right!
|
||||
```
|
||||
|
||||
### 尝试动手
|
||||
|
||||
在学习一门新的编程语言时，这个“猜数字”游戏是一个很好的入门程序，因为它以一种非常直接的方式练习了几个常见的编程概念。通过用不同的编程语言实现这个简单的游戏，您可以演示一些核心概念，并比较每种语言的细节。
|
||||
|
||||
你有最喜欢的编程语言吗?你怎么用该语言编写“猜数字”游戏?跟随本系列文章，查看您可能感兴趣的其他编程语言的示例。
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/21/1/learn-c
|
||||
|
||||
作者：[Jim Hall][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[译者ID](https://github.com/译者ID)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://opensource.com/users/jim-hall
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/lenovo-thinkpad-laptop-concentration-focus-windows-office.png?itok=-8E2ihcF (Woman using laptop concentrating)
|
||||
[2]: https://opensource.com/article/20/8/learn-open-source
|
||||
[3]: https://opensource.com/article/20/12/learn-bash
|
||||
[4]: https://opensource.com/article/20/12/learn-java
|
||||
[5]: https://opensource.com/article/20/12/julia
|
||||
[6]: https://opensource.com/article/20/8/teaching-c
|
||||
[7]: https://opensource.com/article/20/8/c-programming-cheat-sheet
|
||||
[8]: http://www.opengroup.org/onlinepubs/009695399/functions/puts.html
|
||||
[9]: http://www.opengroup.org/onlinepubs/009695399/functions/scanf.html
|
||||
Loading…
Reference in New Issue
Block a user